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Preface 


This technical reference provides information about the Basic 
Input/Output System (BIOS) and Advanced BIOS (ABIOS) interfaces. 
It is intended for developers who provide hardware or software 
products to operate with IBM’ products. 


You should understand the concepts of computer architecture and 
programming before using this publication. 


Warning: The term “Reserved” is used to describe certain signals, 
bits, and registers. Use of reserved areas can cause compatibility 
problems, loss of data, or permanent damage to the hardware. 


This technical reference is divided into two parts: BIOS and 
Advanced BIOS. 


BIOS contains the following: 


Section 1, “Introduction to BIOS,” provides an overview of BIOS, 
interrupts, parameter passing, data areas, and read-only memory 
(ROM) tables. It also describes how to determine the 
system-BlOS version date. 


Section 2, “Interrupts,” contains detailed information about how 
interrupts function across the IBM Personal! System/2” and 
Personal Computer’ product lines. Exceptions between products 
are noted. 


Section 3, “BIOS Data Areas,” contains detailed information 
about regular data areas. 


Section 4, “ROM Tables,” contains detailed information about 
ROM tables for system- and adapter-ROM BIOS. 


Section 5, “Additional Information,” contains information about 
sharing interrupts in IBM Personal System/2 and Personal 
Computer products. It also contains information about 
adapter-ROM calls, video compatibility, and multitasking 
provisions. 


Section 6, “System Identification,” contains information about 
system-identification bytes. 


IBM, Personal System/2, and Personal Computer are trademarks of the International 
Business Machines Corporation. 
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Section 7, “Scan Code/Character Code Combinations,” contains 
information about keyboard keys and scan code/character code 
combinations. 


Advanced BIOS contains the following sections: 


Section 1, “Introduction to Advanced BIOS,” provides an 
overview of Advanced BIOS, data structures, initialization, 
transfer conventions, interrupt processing, and extending ABIOS. 


Section 2, “Data Structures,” contains detailed information on the 
common data area, function transfer tables, device blocks, and 
how these ABIOS data structures are used. 


Section 3, “Initialization,” describes the ABIOS steps and the 
operating-system steps that are necessary to make the ABIOS 
interface operational. 


Section 4, “Transfer Conventions,” describes the methods that 
are used to transfer control to ABIOS-device routines. The 
request block, the ABIOS transfer convention, and the 
operating-system transfer convention are described. 


Section 5, “Additional Information,” contains detailed information 
on interrupt processing; adding, patching, extending, and 
replacing ABIOS; and operating-system implementation 
considerations. 


Section 6, “Interfaces,” describes the interfaces that are 
supported by ABIOS. 


System-specific hardware- and software-interface information for IBM 
systems and for IBM diskette drives, fixed disk drives, adapters, and 
other options is contained in separate technical reference 
publications. 
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Notes: 


1-2 Introduction to BlOS—September 1991 


The Basic Input/Output System (BIOS) for IBM Personal System/2 and 
Personal Computer products is a software interface or “layer” that 
isolates operating systems and application programs from specific 
hardware devices. BIOS routines allow assembly-language 
programmers to perform biock- and character-level operations 
without concern for device addresses or hardware operating 
characteristics. BIOS also provides system services, such as 
time-of-day and memory-size determination. 


Operating systems and application programs should make functional 
requests to BIOS instead of directly manipulating I/O ports and 
control words of the hardware. Hardware design and timing changes 
then become less critical, and software compatibility across systems 
and features is enhanced. 


Interrupts 


BIOS is accessed through software interrupts; each BIOS entry point 
is available through its own interrupt. Within each interrupt, the AH 
register indicates the specific function that is being executed. 


The table on the following page lists each interrupt, its function, and 


whether a detailed description of the interrupt is included in this 
technical reference manual. 
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In This 
Interrupt Technical 
Number Interrupt Function Reference? 


Divide by 0 
Single Step 
Nonmaskabie Interrupt (NMI) 
Breakpoint 
Overflow 
Print Screen 
O6H to 07H Reserved 
08H System Timer 
09H Keyboard 
OAH to 0DH Reserved 
0EH Diskette 
OFH Reserved 
Video 
Equipment Determination 
Memory Size Determination 
Fixed Disk/Diskette 
Asynchronous Communication 
System Services 
Keyboard 
Printer 
Resident BASIC 
Bootstrap Loader 
System-Timer and Real-Time Clock Services 
Keyboard Break 
User Timer Tick 
Video Parameters 
Diskette Parameters 
Video Graphics Characters 
20H to 3FH Diskette BIOS Revector 
41H Fixed Disk Parameters 
42H to 45H Reserved 
46H Fixed Disk Parameters 
47H to 49H Reserved 
4AH User Alarm 
4BH Advanced Services 
4CH to 5FH Reserved 
60H to 67H Reserved for User-Program Interrupts 
68H to 6FH Reserved 
70H Real-Time Clock 
71H to 74H Reserved 
75H Redirect to NMI 
76H to 7FH Reserved 
80H to 85H Reserved 
86H to FOH Used by BASIC Interpreter When Running BASIC 
F1H to FFH Reserved for User-Program Interrupts 


Figure 1-1. Interrupts 
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Parameter Passing 


All parameters that are passed to and from the BIOS routines go 
through the microprocessor registers. Each BIOS interrupt routine 
indicates which registers are used on the call and on the return. In 
general, if a BIOS routine has several possible functions, (AH) is used 
to select the desired function. For example, to set the time, the 
following code is required: 


MOV AH,1 sFunction is to set time of day. 
MOV CX,HIGH_COUNT ;Establish the current time. 
MOV DX,LOW_COUNT  ; 

INT 1AH ;Set the time. 


To read the time, the following code is required: 


MOV AH,O ;Function is to read time of day. 
INT 1AH ;Read the timer. 


| The BIOS interrupt handlers save all registers (including the 

| extended portion) except (AX), the flags, and registers that return 
values to the caller. In some cases, other registers are modified. 
See the “Interrupts” section for additional information. 


All parameters are 1-based (that is, the count starts with 1, not with 
0), unless they are noted as 0-based. 


Data Areas and ROM Tables 


Data areas are the memory locations that are allocated specifically to 
system BIOS and adapter BIOS to be used as work areas. Read-only 
memory (ROM) tables are used by BIOS to define the characteristics 
of hardware devices that are supported by a particular system BIOS 
or adapter BIOS. 


See the “Data Areas” section and the “ROM Tables” section for 
additional information. 
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BiOS-Level Determination 


BIOS is contained in ROM modules on the system boards of Personal 
System/2 and Personal Computer products. It is also contained in 
ROM modules on some optional features (usually adapters) to 
provide device-level control of the features. 


BIOS has been amended several times since it was first developed. 
All BIOS versions are dated. In this technical reference, 
BiOS-version dates are used when necessary to indicate interface 
differences in similar systems. 


To determine the BIOS-version date of a system, run the following 
BASIC program. The date that is displayed is the version date of 
BIOS for that system. 


10 DEF SEG=&HFO00 

20 FOR X=8HFFF5 TO &HFFFC 
30 PRINT CHR$(PEEK(X)); 
40 NEXT 

RUN 


See “System Identification” in the “Additional Information” section 
for a list of IBM products and their BIOS-version dates. To access 
this information, see Interrupt 15H, Return System Configuration 
Parameters function ((AH)=COH). 


System Groups 


In this technical reference, IBM systems are categorized into groups 
of systems that have similar BIOS interfaces. When these groups are 
referred to, any exceptions are noted. These groups include: 


¢ Personal System/2 products, all models 
Personal Computer XT° products, including the Portable Personal 
Computer. 

¢ Personal Computer AT" products, all models. 


Personal Computer XT and Personal Computer AT are trademarks of the 
International Business Machines Corporation. 


1-6 = Introduction to BlIOS—September 1991 


Section 2. Interrupts 
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Notes: 


2-2. Interrupts—September 1991 


Interrupt 02H—Nonmaskable Interrupt (NMI) 


| The nonmaskable interrupt (NMI) handler is used to process severe 
| errors. In most cases, the fault is in the hardware, but it is also 
| possible for a software error to force an NMI to occur. 


| When an NMI occurs, the interrupt handler displays the error code 
| that is associated with the error and halts the processor. The error 
codes are as follows. 


Value Description 


|| Parity check 1 System-board memory failure 
|| Parity check 2 (/O-channel parity error 
System-board memory failure 
Channel check activated (assumes channel memory) 
Watchdog time-out 
Direct memory access (DMA) bus time-out 
System-board memory failure 
Channel check activated (assumes channel memory) 
|} 00021000 System-board memory failure 
000210xy System-board memory failure in memory module x, 

which is of type y 
|| 00021100 Channel check activated (assumes channel memory) 
000211x0 Channel check activated in slot x 
Oxxx 1200 Watchdog time-out 
| xxx = 129 - Processor card 

=001 - System board 

0xxx 1300 Direct memory access (DMA) bus time-out 

Xxx = 129 - Processor card 
| =001 - System board 
01290400 Level 2 cache memory failure 


Note: Not all codes apply to every system. 
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Figure 2-1. Nonmaskable Interrupt Error Codes 


When a system-board memory failure (parity error) occurs, the NMI 
handler attempts to find the storage location that contains the bad 
parity. If the location is found, the segment address is displayed. If 


| indicating an intermittent read problem. When performing this test, 

| the NMI handler does not check memory above 640KB, so it is 

| possible for a recurring problem to exist that the NMI handler cannot 
| find. Some of the Personal System/2 Model 90 and 95 systems 

| display the socket number of the memory module that contains the 

| error, and they display the type of the memory module. 
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| When a channel check occurs, the NMI handler assumes that the 

| error was caused by an error in a channel adapter card. The 

| Personal System/2 Model 90 and 95 systems attempt to determine 

| which card caused the error and display the slot number along with 
| the error code. 


When the watchdog timer is enabled and a timer interrupt (IRQ 0) is 
missing, the system generates an NMI. 


When a DMA-driven device uses the bus longer than the allowable 
time period (7.8 microseconds) after it is preempted by another 
device, the central arbitration control point generates an NMI. 


When an NMI occurs, the central arbitration control point is implicitly 
disabled. The NMI handler explicitly reenabies the central arbitration 
control point by writing hex 0 to port hex 90. 


A system that has a math coprocessor must direct math coprocessor 
errors to this interrupt. An 8087 math coprocessor error on 8088- or 
8086-based sysiems drives the NMI of the 8088 or 8086, respectively. 
An 80287 or 80387 math coprocessor error on 80286-, 80386-, and 
80486-based systems drives the IRQ 13 line. The IRQ 13 interrupt 
handler issues a software Interrupt 02H to be compatible with 
software that expects the NMI to occur. For all systems, the math 
coprocessor application that points the NMI vector to itself must be 
sensitive to NMI errors. If an NMI occurs because of an NMI error, 
control should be transferred to the system NMI handler. 


Notes: 
1. For PCjr’, the NMI is attached to the keyboard interrupt. 


2. For PC Convertible, the NMI is attached to the keyboard, the 
diskette, the real-time clock, and the system-suspend interrupts. 
The NMI is activated by an I/O channel check. 


* PCjr is a trademark of the International Business Machines Corporation. 
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Interrupt 05H—Print Screen 


| This interrupt handler prints the screen to printer port 0. When 
Interrupt 05H is invoked, the cursor position is saved and is restored 
when the interrupt is completed. Interrupt 05H runs with interrupts 
enabled; however, additional print-screen requests are ignored when 
a print-screen operation is already in progress. An initial status error 
from the printer ends the print-screen request. The byte at address 
hex 50:00 contains the status of the print-screen operation. 


The following figure lists the status indications for the print-screen 
status byte (address hex 50:00). 


Description 


Print screen not called or, on return, operation successfully 


completed 
Print screen in progress, ignore request 
Error encountered during printing 


Figure 2-2. Print Screen Status 
For PC Convertibte, an initial status error ends the print-screen 


request and also sounds a “beep.” The Ctrl-Break sequence ends the 
print-screen operation. 
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Notes: 
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interrupt 08H—System Timer 


This interrupt handler services the timer interrupt from channel 0 of 


| the system timer. This interrupt occurs approximately 18.2 times per 
| second. 


The interrupt handler: 


¢ Maintains a count of interrupts at data area address hex 40:6C 
(timer counter) since power-on that can be used to establish the 
time of day. After 24 hours of operation, address hex 40:70 (timer 
| overflow) is increased (made nonzero). When the time counter 
crosses a day boundary, address hex 40:CE (day counter) is 
increased. 


* Decreases the value at address hex 40:40 (motor-off counter of 
the diskette drive) and, when the count reaches 0, turns the 
diskette-drive motor off and resets the motor-running flags in 
address hex 40:3F (motor status). 


¢ issues a software Interrupt 1CH. 


For PC Convertible, this interrupt handler calis a user routine through 
software Interrupt 4AH when an alarm interrupt occurs. 


5: 
= 
@ 
3 
Cc 
0 
= 
j=) 
es) 
T 
i) 
< 
n 
oa 
2 
= 
=I 
3 
@ 
oN 


System Timer—September 1991 2-INO8-1 


Notes: 
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Interrupt 09H—Keyboard 


This interrupt handler is issued on the make or break of every 
keystroke. 


For ASCII keys, when a make code is read from port hex 60, the 
character code and scan code are put into the 32-byte keyboard 
buffer that begins at address hex 40:1E in the BIOS data area, at the 
address pointed to by the keyboard-buffer tail pointer (hex 40:1C). 
The keyboard-buffer tail pointer is then increased by 2, unless it 
extends past the end of the buffer. In this case, it is reinitialized to 
the start of the buffer. 


For every Ctrl, Alt, or Shift key make or break, BIOS data area 
addresses hex 40:17 and hex 40:18 (keyboard control) and hex 40:96 
(keyboard flags) are updated. 


The Ctrl-Alt-Delete sequence causes the interrupt handler to set the 
reset flag (hex 40:72) to hex 1234 (bypass memory test) then jump to 
the power-on self-test (POST). POST checks the reset flag (hex 
40:72); if the reset flag is set to hex 1234, POST does not retest the 
memory. For the PC Convertible, a processor reset is performed 
instead of a jump to POST, causing POST to be executed. 


Pressing the Pause key causes the interrupt handler to loop until a 
valid ASCIi keystroke occurs. The PC Convertible issues Interrupt 
15H, Wait for External Event function ((AH) = 41H) to wait for a valid 
ASCII keystroke. 


Pressing the Print Screen key causes Interrupt 05H (Print Screen) to 
be issued. 


The Ctril-Break sequence causes Interrupt 1BH (Keyboard Break) to 
be issued. 


For PC/XT’ BIOS dated 1/10/86 and later, AT’, PC/XT Model 286, PC 
Convertible, and Personal System/2 products, pressing the SysRq key 
causes the interrupt handler to issue Interrupt 15H, System Request 
Key Pressed function ((AH) = 85H) to inform the system cf a SysRq 
key make or break operation. Also, the keyboard interrupt issues 


* PC/XT and AT are trademarks of the Internationa! Business Machines Corporation. 


Keyboard—September 1991 2-IN09-1 


ay 
= 
co) 
x 
= 
Cc 
ae) 
a 
Q 
© 
Tt 
A 
@ 
< 
ox 
ce) 
pe) 
x 
on 


Interrupt 15H, Interrupt Complete function ((AH) = 91H) with (AL) =02H 
(Type = Keyboard) to indicate that a keystroke is available. 


For AT BIOS dated 6/10/85 and later, PC/XT Model 286, PC 
Convertible, and Personal System/2 products, Interrupt 15H, 
Keyboard Intercept function ((AH)=4FH) is issued after the scan code 
is read from port hex 60. This allows the system to replace or absorb 
the scan code. An End of Interrupt (EOI) instruction is processed by 
the Interrupt 09H handler after control is returned from the keyboard 
intercept handler. 


| For Personal System/2 Model 56, Model 57, Model 90, and Model 95, 
| the following procedure causes the system to be booted from the 
| system partition on the fixed disk: 


| 1. Perform a Ctrl-Alt-Delete sequence. 


| 2. Wait for the cursor to appear in the upper-right corner of the 
| display. 


3. Perform a Cirl-Alt-Insert sequence. 
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Interrupt 10H—Video 


The following is a summary of the video functions of Interrupt 10H. 


(AH) = OOH — Set Mode 

(AH) = 01H — Set Cursor Type 

(AH) = 02H — Set Cursor Position 

(AH) = 03H — Read Cursor Position 

(AH) = 04H — Read Light-Pen Position 

(AH) = 05H — Select Active Display Page 

(AH) = O6H — Scroll Active Page Up 

(AH) = 07H — Scroll Active Page Down 

(AH) = 08H — Read Attribute/Character at Current Cursor Position 
(AH) = OSH — Write Attribute/Character at Current Cursor Position 
(AH) = OAH — Write Character at Current Cursor Position 

(AH) = OBH — Set Color Palette 

(AH) = OCH — Write Dot 

(AH) = ODH — Read Dot 

(AH) = OEH — Write Teletype to Active Page 

(AH) = OFH — Read Current Video State 

10H — Set Palette Registers 

11H — Character Generator 

12H — Alternative Selection 

13H — Write String 

14H — Load LCD Character Font/Set LCD High-Intensity Substitute 
15H — Return Physical-Display Parameters for Active Display 
16H to 19H — Reserved 

1AH — Read/Write Display-Combination Code 

1BH — Return Functionality/State Information 

1CH — Save/Restore Video State 

1DH to FFH — Reserved 


Het ft bad tt &# ob ott 


Figure 2-3. INT 10H Video Functions 


Note: All reserved input fields must be set to 0. 
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(AH) = 00H—Set Mode 


(AL) - Requested video mode 


The following table lists the supported video modes. 


Maximum 
Colors 


NO 
Aon 


a 


4, 
6 
7 
8 
9 
A 
B 
D 
E 
F 


Monochrome 


APA= All points addressable (graphics) 
A/N= Alphanumeric (text) 


Figure 2-4. Video Modes 
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Alphanumeric 
Format 


40x25 
80x25 
40x25 
80x25 
80x25 
20x25 
40x25 
80x25 


40x25 
80x25 
80x25 
80x25 
80x30 
80x30 
40x25 
132x25 


Buffer 
Start 


B8000H 
B8000H 
B8000H 
B8000H 
BO000H 
BOO00H 
BOO00H 
BO000H 


A0000H 
A0000H 
A0000H 
AQ000H 
AO000H 
AQ000H 
AQ000H 
B8000H 


The following table lists the characteristics of each video subsystem 
for each of the video modes. 


Display 
Size Supporting IBM Products 


320x200 PCjr, Color/Graphics Monitor 
Adapter (CGA), Enhanced 
Graphics Adapter (EGA), PC 
Convertible, and Personal 
System/2 products except Model 
25 and Model 30 

320x350 EGA and Personal System/2 
products except Model 25 and 
Model 30 

320x400 Personal System/2 Mode! 25 and 
Model 30 

360x400 Personal System/2 products 
except Model 25 and Model 30 

640x200 PCjr, CGA, and PC Convertible 

640x200 EGA and Personal System/2 
products except Model 25 and 
Model 30 

640x350 EGA and Personal System/2 
products except Model 25 and 
Model 30 

640x400 Personal System/2 Model 25 and 
Model 30 

720x400 Personal System/2 products 
except Model 25 and Model 30 

320x200 PCjr, CGA, EGA, and Personal 
System/2 products 

640x200 PCjr, CGA, EGA, and Personal 
System/2 products 

720x350 Monochrome Display and Printer 
Adapter (MDPA) and PC 
Convertible 

720x350 EGA and Personal System/2 
products except Model 25 and 
Model 30 

720x400 Personal System/2 products 
except Model 25 and Model 30 

640x200 PC Convertible 

160x200 PCjr 

320x200 PCjr 

640x200 PCjr 

Reserved 


Figure 2-5 (Part 1 of 2). Video Mode Characteristics 
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Display Box Maximum 
Size Size Supporting IBM Products Pages 


320x200 8x8 EGA and Personal System/2 8 
products except Model 25 and 
Model 30 

640x200 8x8 EGA and Personal System/2 
products except Model 25 and 
Model 30 

640x350 8x14 EGA and Personai System/2 
products except Model 25 and 
Model 30 

640x480 0s 8x 16 Personal System/2 products 

640x480 8x16 Personal System/2 products 
except Model 25 and Model 30 

320x200 8x8 Personal System/2 products 

1056x200 8x8 Personal System/2 Model 90 and 
Model! 95 with IML update, Model 
35 LS, Model 35 SX, Model 40 
SX, and Model 57 SX 

1056x350 8x14 Persona! System/2 Model 90 and 
Model 95 with IML update, Model 
35 LS, Model 35 SX, Mode! 40 
SX, and Model 57 SX 

1056x400 8x16 Personal System/2 Model 90 and 
Model! 95 with IML update, Model 
35 LS, Model 35 SX, Model 40 
SX, and Model 57 SX 


Figure 2-5 (Part 2 of 2). Video Mode Characteristics 


Notes: 
1. For PCjr and IBM Color/Graphics Monitor Adapter (CGA): 


¢ The cursor is not displayed in graphics (APA) modes. 

¢ Modes 0, 2, and 5 are identical to modes 1, 3, and 4, except 
that color burst is not enabled. Color-burst-on enables color 
information on composite displays; color-burst-off disables it. 
RGB displays are not affected by the state of color burst. 

¢ For PCjr during mode setting, if bit 7 of (AL) is set to 1, the 
video buffer is not cleared. 


2. For IBM Enhanced Graphics Adapter (EGA): 


¢ The cursor is not displayed in graphics (APA) modes. 

¢ Modes 0, 2, and 5 are identical to modes 1, 3, and 4, except 
that color burst is not enabled. Color-burst-on enables color 
information on composite displays; color-burst-off disables it. 
RGB displays are not affected by the state of color burst. 

¢ The power-on default mode is determined by switch settings 
on the adapter. 
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During mode setting, if bit 7 of (AL) is set to 1, the video 
buffer is not cleared. 


See BIOS data area address hex 40:A8 in “BIOS Data Areas” for 
save-pointer dynamic overrides. 


3. For 


PC Convertible: 


The cursor is not displayed in graphics (APA) modes. 

Modes 0, 2, and § are identical to modes 1, 3, and 4, except 
that color burst is not enabled. Color-burst-on enables color 
information on composite displays; color-burst-off disables it. 
RGB displays are not affected by the state of color burst. 

The power-on default mode for the color/graphics mode is 2. 
The power-on default mode for the monochrome mode is 7. 
During mode setting, if bit 7 of (AL) is set to 1, the video 
buffer is not cleared. 

Mode 7 (640x200) is used for a liquid crystal display (LCD) as 
monochrome. 

Mode 7 (720x350) is used for a monochrome display. 


Personal System/2 Model 25 and Model 30: 


The cursor is not displayed in graphics (APA) modes. 
Modes 0, 2, and 5 are identical to modes 1, 3, and 4. 

The power-on default mode is 3. 

During mode setting, if bit 7 of (AL) is set to 1, the video 
buffer is not cleared. 

In all modes except mode hex 13, the first 16 color registers 
are initialized, and the values in the remaining 240 color 
registers are undefined. 

In mode hex 13, 248 color registers are loaded. 


Personal System/2 products except Model 25 and Model 30: 


The cursor is not displayed in graphics (APA) modes. 
Modes 0, 2, and 5 are identical to modes 1, 3, and 4. 

When a color display is attached, the power-on default mode 
is 3. When a monochrome display is attached, the power-on 
default mode is 7. 

During mode setting, if bit 7 of (AL) is set to 1, the video 
buffer is not cleared. 

In all modes except mode hex 13, the first 64 color registers 
are initialized, and the values in the remaining 192 color 
registers are undefined. 

Refer to (AH) = 12H, (BL) = 30H on page 2-IN10-22 to select 
scan lines (200, 350, or 400) for alphanumeric modes. 


See BIOS data area address hex 40:A8 in “BIOS Data Areas” for 
save-pointer dynamic overrides. 
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(AH) = 01H—Set Cursor Type 


(CH) - Top line for cursor (bits 4 to 0) 
(Hardware causes blinking cursor; 
setting bit 6 or 5 causes erratic 
blinking or no cursor.) 

(CL) - Bottom line for cursor (bits 4 to 0) 


Notes: 
1. BIOS maintains only one cursor type for all video pages. 


2. For Personal System/2 Model 25 and Model 30, before the 
hardware video ports are written to, (CH) is multiplied by 2, and 
(CL) is multiplied by 2 and increased by 1. 


(AH) = 02H—Set Cursor Position 


(BH) - Page number (0 based); see Figure 2-5 on page 2-IN10-3 for 
maximum pages 
(DH,DL) - Row, column (0,0 is upper left) 


(AH) = 03H—Read Cursor Position 


(BH) - Page number (0 based); see Figure 2-5 on page 2-IN10-3 for 
maximum pages 


On Return: 


(CH,CL) - Cursor type currently set 
(DH,DL) - Row, column of current cursor for requested page 


(AH) = 04H—Read Light-Pen Position 


For PC Convertible and Personal System/2 products, this function 
is not supported: 


On Return: 
(AH) = OOH - Light pen is not supported 
(BX), (CX), and (DX) are altered on return. 


For all others: 


On Return: 
(AH) = OOH - Light-pen switch not activated 
(BX), (CX), and (DX) are altered on return. 
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(AH) = 01H - Valid light-pen value in registers 
(BX) - Pel column (from 0 to 319 639) 
(CH) - Raster line (from 0 to 199) 
(CX) - Raster line (from 0 to nnn), new graphics modes 
(DH,DL) - Row, column of character 


(AH) = 05H—Select Active Display Page 
For PCjr: 
(AL) = 80H - Read microprocessor- and display-page registers 


(AL) = 81H - Set microprocessor-page register 
(BL) - Microprocessor-page register 


(AL) = 82H - Set display-page register 
(BH) - Display-page register 


(AL) = 83H - Set microprocessor- and display-page registers 
(BH) - Display-page register 
(BL) - Microprocessor-page register 


On Return: 


(BH) - Display-page register 
(BL) - Microprocessor-page register 


For all others: 


(AL) - New page number (0 based); see Figure 2-5 on page 2-IN10-3 for 


maximum pages 


(AH) = 06H—Scroll Active Page Up 


(AL) - Number of lines to be blanked at bottom of window 
= OOH - Blank entire window 

(BH) - Attribute to be used on blank line 

(CH,CL) - Row, column of upper-left corner of scroll 

(DH,DL) - Row, column of lower-right corner of scroll 


(AH) = 07H—Scroll Active Page Down 


(AL) - Number of input lines to be blanked at top of window 
= 00H - Blank entire window 

(BH) - Attribute to be used on blank line 

(CH,CL) - Row, column of upper-left corner of scroll 

(DH,DL) - Row, coftumn of lower-right corner of scroll 
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(AH) = 08H—Read Attribute/Character at Current Cursor Position 


(BH) - Page number (0 based); see Figure 2-5 on page 2-IN10-3 for 
maximum pages 


On Return: 
(AH) - Attribute of character that was read (alphanumeric modes only) 
(AL) - Character that was read 


(AH) = 09H—Write Attribute/Character at Current Cursor Position 


For the read- and write-character interface in graphics modes 4, 5, 
and 6, the characters are formed from a character generator that is 
maintained in the system ROM, which contains only the first 128 
characters. To read or write the second 128 characters, initialize the 
pointer at interrupt vector hex 1F (address hex 0007C) to point to the 
1KB table that contains the code points for the second 128 characters 
(128 to 255). 


In all other graphics modes, 256 graphics characters are supplied in 
the system ROM. 


For the write-character interface in graphics mode, the character 
count that is contained in (CX) produces valid results for characters in 
the same row only. Continuation to succeeding rows produces 
invalid results. 


(AL) - Character to be written 

(BH) - Page number (0 based); see Figure 2-5 on page 2-IN10-3 for 
maximum pages 

(BL) - Attribute of character (alphanumeric) or color of 
character (graphics) 

(CX) - Count of characters to be written 


Notes: 


1. The Write Attribute/Character function ((AH)= 09H) and the Write 
Character function ((AH) =0AH) are similar. Use the Write 
Attribute/Character function ((AH) = 09H) for graphics modes. 


2. In graphics modes, if bit 7 of (BL) is set to 1, the color value is 
exclusively ORed with the current video memory (except in mode 
hex 13). 


3. In mode hex 13, the value that is passed in (BH) is used as the 
background color. 
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(AH) = OAH—Write Character at Current Cursor Position 


(AL) - Character to be written 


(BH) - Page number (0 based); see Figure 2-5 on page 2-IN10-3 for 
maximum pages 
(CX) - Count of characters to be written 


Use the Write Attribute/Character function ((AH) =09H) for graphics 
modes. 


(AH) = OBH—Set Color Palette 


(BH) - Color !D being set (from 0 to 1) 
(BL) - Color value to be used with color ID 


(BH) = GOH - For 320x200 graphics modes, set background color 
- For alphanumeric modes, set border color 


- For 640x200 graphics modes, set foreground color 
(BL) = from 0 to 31 


(BH) = 01H - Select palette for 320x200 graphics modes 
(BL) = 0- Green (1)/red (2)/brown (3) 
= 1- Cyan (1)/magenta (2)/white (3) 


Notes: 


1. This interface has meaning for 320x200 graphics modes only. 


2. In 40x25 or 80x25 alphanumeric modes, the value that is set for 
palette color 0 indicates which border color is to be used (0 to 
31); values 16 to 31 indicate the high-intensity background set. 


3. For EGA and Personal System/2 products, when the 640x200 


graphics mode is active and the color ID is 0, the background 
color is set. 


(AH) = 0CH—Write Dot 
(AL) - Color value 


(CX) - Column number 
(DX) - Row number 


Note: If bit 7 of (AL) is set to 1, the color value is exclusively ORed 
with the current contents of the dot (except in mode hex 13). 


In graphics modes that support more than one page: 


(BH) - Page number (0 based); see Figure 2-5 on page 2-IN10-3 for 
maximum pages 
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(AH) = ODH—Read Dot 


(CX) - Column number 
(DX) - Row number 


In graphics modes that support more than one page: 


(BH) - Page number (0 based); see Figure 2-5 on page 2-IN10-3 for 
maximum pages 


On Return: 
(AL) - Dot that was read 


(AH) = 0OEH—Write Teletype to Active Page 


(AL) - Character to be written 
(BL) - Foreground color in graphics mode 


Notes: 
1. The mode that is currently set controls the screen width. 


2. Carriage Return, Line Feed, Backspace, and Bell are treated as 
commands, not as printable characters. 


3. For PC BIOS dated 4/24/81 and 10/19/81, (BH) must be set to the 
active page. 


(AH) = OFH—Read Current Video State 


On Return: 
(AH) - Number of character columns on screen 
(AL) - Mode that is currently set 
(see (AH) =00H on page 2-IN10-2 for explanation) 
(BH) - Current active page number (0 based); see 
Figure 2-5 on page 2-IN10-3 for maximum pages 


(AH) = 10H—Set Palette Registers 


For PCjr, systems with EGA capability, and Personal System/2 
products except Model 25 and Model 30: 


(AL) = OOH - Set individual palette register 
(BH) - Value to be set 
(BL) - Palette register to be set 


(AL) = 01H - Set overscan register 
(BH) - Value to be set 
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(AL) = 02H - Set all palette registers and overscan 
(ES:DX) - Pointer to 17-byte table 
Byte 16 - Overscan value 
Bytes 15 to 0 - Palette vaiues 


(AL) = 03H - Toggle intensify/blinking bit 
(BL) = 00H - Enable intensify 
= 01H - Enable blinking 


For Personal System/2 products except Model 25 and Model 30: 


(AL) = 04H to 06H - Reserved 


(AL) = 07H - Read individual palette register 
(BL) - Palette register to be read (from 0 to 15) 


On Return: 
(BH) - Value that was read 


(AL) = 08H - Read overscan register 


On Return: 
(BH) - Value that was read 


(AL) = OSH - Read all palette registers and overscan 
(ES:DX) - Pointer to 17-byte buffer for return values 


On Return: 
(ES:DX) - Pointer to 17-byte table destination 
Byte 16 - Overscan value 
Bytes 15 to 0 - Palette values 


(AL) = 10H - Set individual color register 
(BX) - Color register to be set 
(CH) - Green value to be set 
(CL) - Blue value to be set 
(DH) - Red value to be set 


(AL) = 11H - Reserved 


(AL) = 12H - Set block of color registers 
(BX) - First color register to be set 
(CX) - Number of color registers to be set 
(ES:DX) - Pointer to table of color values 
(Tabie format: red, green, blue, red, green, blue) 


(AL) = 13H - Select color page (not valid for mode hex 13) 
(BH) - Paging mode 
= 00H - Selects 4 register blocks of 64 registers 
= O1H - Selects 16 register blocks of 16 registers 
(BL) = OOH - Select paging mode 
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(BH) - Page number (0 based); see Figure 2-5 on page 2-IN10-3 
for maximum pages 
For 64-register block mode: 
= 00H - Selects first block of 64 color registers 
= O1H - Selects second block of 64 color registers 
= 02H - Selects third block of 64 color registers 
= 03H - Selects fourth block of 64 color registers 
For 16-register block mode: 
= OOH - Selects first block of 16 color registers 
= 01H - Selects second block of 16 color registers 


= OFH - Selects 16th block of 16 color registers 
(BL) = O1H - Select page 


Note: The Set Mode function ((AH) =00H) defaults to the 64-register 
block mode, with the first block of 64 color registers active. 
Only these 64 color registers are initialized during mode 
setting. When using page selection, initialize the other blocks 
of the color registers. 


(AL) = 14H - Reserved 


(AL) = 15H - Read individual color register 
(BX) - Color register to be read 


On Return: 
(CH) - Green value that was read 
(CL) - Blue value that was read 
(DH) - Red value that was read 


(AL) = 16H - Reserved 
(AL) = 17H - Read block of color registers 
(BX) - First color register to be read 
(CX) - Number of color registers to be read 
(ES:DX) - Pointer to destination table for values 
(Table format: red, green, blue, red, green, blue) 


On Return: 
(ES:DX) - Pointer to table of values 


(AL) = 18H to 19H - Reserved 
(AL) = 1AH - Read color-page state 
On Return: 


(BH) - Current page 
(BL) - Current paging mode 
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Note: See (AL)= 13H on page 2-IN10-11 for paging modes and page 
information. 


(AL) = 1BH - Sum color values to gray shades 
(BX) - First color register to be summed 
(CX) - Number of color registers to be summed 


Note: This call reads the red, green, and blue values that are found 
in the color registers, performs a weighted sum (30% red + 
59% green + 11% blue), then writes the result into each red, 
green, and blue component of the color register (the original 
data is not retained). 


For Personal System/2 Mode! 25 and Model 30: 


(AL) = 00H 
(BX) = 0712H - Color registers to be set, resulting 
in 8 consistent colors 


(AL) = 01H to 02H - Reserved 


(AL) = 03H - Toggle intensify/blinking bit 
(BL) = OOH - Enable intensify 
= 01H - Enable blinking 


(AL) = 04H to 07H - Reserved 


(AL) = 10H - Set individual color register 
(BX) - Color register to be set 
(CH) - Green value to be set 
(CL) - Blue value to be set 
(DH) - Red value to be set 


(AL) = 11H - Reserved 


(AL) = 12H - Set block of color registers 
(BX) - First color register to be set 
(CX) - Number of color registers to be set 
(ES:DX) - Pointer to table of color values 
(Table format: red, green, blue, red, green, blue) 


(AL) = 13H to 14H - Reserved 


(AL) = 15H - Read individual color register 
(BX) - Color register to be read 


On Return: 
(CH) - Green value that was read 
(CL) - Blue value that was read 
(DH) - Red value that was read 


(AL) = 16H - Reserved 
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(AL) = 17H - Read a block of color registers 
(BX) - First color register to be read 
(CX) - Number of color registers to be read 
(ES:DX) - Pointer to destination table for values 
(Table format: red, green, blue, red, green, blue) 


On Return: 
(ES:DX) - Pointer to table of values 


(AL) = 18H to 1AH - Reserved 


(AL) = 1BH - Sum color values to gray shades 
(BX) - First color register to be summed 
(CX) - Number of color registers to be summed 


Note: This call reads the red, green, and blue values that are 
found in the color registers, performs a weighted sum 
(30% red + 59% green + 11% blue), then writes the 
result into each red, green, and biue component of the 
color register (the original data is not retained). 


For all others, no action is performed. 
(AH) = 11H—Character Generator 


For systems with EGA capability, this call initiates a mode setting that 
completely resets the video environment but maintains the 
regenerative buffer. 


(AL) = OOH - User alphanumeric load 
(BH) - Number of bytes per character 
(BL) - Block to be loaded 
(CX) - Count to be stored 
(DX) - Character offset into table 
(ES:BP) - Pointer to user table 


(AL) = 01H - ROM monochrome set 
(BL) - Block to be loaded 


(AL) = 02H - ROM 8x8 double dot 
(BL) - Block to be loaded 


(AL) = 03H - Set block specifier (valid in alphanumeric modes) 
(BL) - Character-generator block selection 
If bit 3 of the character-attribute byte is set to 0, 
bits 1 and 0 of (BL) select a block from 0 to 3. 
If bit 3 of the character-attribute byte is set to 1, 
bits 3 and 2 of (BL) select a block from 0 to 3. 


2-IN10-14 Video—September 1991 


For example: 


¢ To set a 256-character set using block 3, set (BL) to hex OF; this 
selects a single block. Bit 3 of the character-attribute byte turns 
the foreground intensity on or off. 


* To specify a 512-character set using blocks 0 and 3, set (BL) to 
hex OC; this selects block 0 when bit 3 of the character-attribute 
byte is set to 0, and it selects block 3 when bit 3 of the 
character-attribute byte is set to 1. 


If bits 1 and 0 and bits 3 and 2 are the same, only one block is 
selected, and bit 3 of the character-attribute byte turns the foreground 
intensity on or off. 


When the 512-character set is active, a function call with (AX) set to 
hex 1000 and (BX) set to hex 0712 is recommended to set the color 
registers with eight consistent colors. 


Register values (AL) = 10H, 11H, and 12H are similar to register 
values (AL) =00H, 01H, and 02H, respectively, with the following 
exceptions: 


Page 0 must be active. 
Points (bytes per character) are recalculated. 
Rows are calculated as follows: 
INT [(200 or 350) / points] — 1 
¢ The length of the regenerative buffer is calculated as follows: 


{Number of rows on screen) x (Number of columns on screen) x 2 


¢ The display controller registers are reprogrammed as follows: 


Maximum scan line Points — 1 
Cursor start Points - 2 
Cursor end Points — 1 
Vertical display end [(Number of rows on screen) x Points] — 1 
Underline location Points — 1 


(mode hex 7 only) 


e¢ Register calculations must be close to the original table values, 
or the results might be unpredictable. 
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(AL) = 10H - User alphanumeric load 
(BH) - Number of bytes per character 
(BL) - Block to be loaded 
(CX) - Count to be stored 
(DX) - Character offset into table 
(ES:BP) - Pointer to user table 


(AL) = 11H - ROM monochrome set 
(BL) - Block to be loaded 


(AL) = 12H - ROM 8x8 double dot 
(BL) - Block to be loaded 


(AL) = 20H - Set user-graphics-characters pointer at Interrupt 1FH 
(ES:BP) - Pointer to user table 


(AL) = 21H - Set user-graphics-characters pointer at Interrupt 43H 
(BL) - Row specifier 
= OOH - User 
(CX) - Points (bytes per character) 
(DL) - Rows 
= O1H - 14 (OEH) 
= 02H - 25 (19H) 
= 03H - 43 (2BH) 
(ES:BP) - Pointer to user table 


(AL) = 22H - ROM 8x14 set 
(BL) - Row specifier 


(AL) = 23H - ROM 8x8 double dot 
(BL) - Row specifier 


Note: (AL)=10H, 11H, 12H, 20H, 21H, 22H, or 23H should be called 
only immediately after a mode setting is issued, or the results 
might be unpredictable. 


(AL) = 30H - Information 
(BH) - Font pointer 

= 00H - Return current Interrupt 1FH pointer 
= 01H - Return current Interrupt 44H pointer 
= 02H - Return ROM &x14 font pointer 
= 03H - Return ROM double-dot pointer 
= 04H - Return ROM double-dot pointer (top) 
= 05H - Return ROM alphanumeric alternative 9x14 


On Return: 
(CX) - Points 
(DL) - Rows 
(ES:BP) - Pointer to table 
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For Personal System/2 products except Modei 25 and Model 30: 


(AL) = 00H - User alphanumeric load 
(BH) - Number of bytes per character 
(BL) - Block to be loaded 
(CX) - Count to be stored 
(DX) - Character offset into table 
(ES:BP) - Pointer to user table 


(AL) = 01H - ROM 8x14 font 
(BL) - Block to be loaded 


(AL) = 02H - ROM 8x8 double-dot font 
(BL) - Block to be loaded 


(AL) = 03H - Set block specifier (valid in alphanumeric modes) 
(BL) - Character-generator block selection 
If bit 3 of the character-attribute byte is set to 0, 
bits 4, 1, and 0 of (BL) select a block from 0 to 7. 
If bit 3 of the character-attribute byte is set to 1, 
bits 5, 3, and 2 of (BL) select a block from 0 to 7. 


For example: 


¢ To set a 256-character set using biock 6, set (BL) to hex 034A; this 
selects a single block. Bit 3 of the character-attribute byte turns 
the foreground intensity on or off. 


* To specify a 512-character set using blocks 0 and 6, set (BL) to 
hex 028; this selects block 0 when bit 3 of the character-attribute 
byte is set to 0, and it selects block 6 when bit 3 of the 
character-attribute byte is set to 1. 


lf bits 4, 1, and 0 and bits 5, 3, and 2 are the same, only one block is 
selected, and bit 3 of the character-attribute byte turns foreground 
intensity on or off. 


When the 512-character set is active, a function call with (AX) set to 
hex 1000 and (BX) set to hex 0712 is recommended to set the color 
registers with eight consistent colors. 


(AL) = 04H - ROM 8x16 font 
(BL) - Block to be loaded 


Register values (AL) = 10H, 11H, 12H, and 14H are similar to register 
values (AL) = 00H, 01H, 02H, and 04H, respectively, with the following 
exceptions: 


Page 0 must be active. 
¢ Points (bytes per character) are recalculated. 


Video—September 1991  2-IN10-17 


¢ Rows are calculated as follows: 


INT [(200, 350, or 450) / points] — 1 


e The length of the regenerative buffer is calculated as follows: 


(Number of rows on screen) x (Number of columns on screen) x 2 


¢ The display controller registers are reprogrammed as follows: 


Maximum scan line Points — 1 
Cursor start Points — 2 
Cursor end Points — 1 


Vertical displacement end —_— For 350- and 400-scan-line modes: 
[(Number of rows on screen) x Points] — 1 
For 200-scan-line modes: 
{[(Number of rows on screen) x Points] x 2} -— 1 
Underline location Points — 1 
(mode hex 7 only) 


¢ Register calculations must be close to the original table values, 
or the results might be unpredictable. 


(AL) = 10H - User alphanumeric load 
(BH) - Number of bytes per character 
(BL) - Block to be loaded 
(CX) - Count to be stored 
(DX) - Character offset into table 
(ES:BP) - Pointer to user table 


(AL) = 11H - ROM 8x14 font 
(BL) - Block to be loaded 


(AL) = 12H - ROM 8x8 double-dot font 
(BL) - Block to be loaded 


(AL) = 14H - ROM 8x16 font 
(BL) - Block to be loaded 


(AL) = 20H - Set user-graphics-characters pointer at interrupt 1FH 
(ES:BP) - Pointer to user table 


(AL) = 21H - Set user-graphics-characters pointer at Interrupt 43H 
(BL) - Row specifier 
= OOH - User 
(CX) - Points (bytes per character) 
(DL) - Rows 
= O1H - 14 (OEH) 
= 02H - 25 (19H) 
= 03H - 43 (2BH) 
(ES:BP) - Pointer to user table 


(AL) = 22H - ROM 8x14 font 
(BL) - Row specifier 
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(AL) = 23H - ROM 8x8 double-dot font 
(BL) - Row specifier 


(AL) = 24H - ROM 8x16 font 
(BL) - Row specifier 


Note: (AL)=10H, 11H, 12H, 14H, 20H, 21H, 22H, 23H, or 24H should 
be called only immediately after a mode setting is issued, or 
the results might be unpredictable. 


(AL) = 30H - Information 
(BH) - Font pointer 
= OOH - Return current Interrupt 1FH pointer 
= 01H - Return current Interrupt 43H pointer 
= 02H - Return ROM 8x14 font pointer 
= 03H - Return ROM 8x8 font pointer 
04H - Return ROM 8x8 font pointer (top) 
O5H - Return ROM 9x14 font alternative 
06H - Return ROM 8x16 pointer 
07H - Return ROM 9x16 font alternative 


wooed od 


On Return: 
(CX) - Points 
(DL) - Rows (number of character rows on screen — 1) 
(ES:BP) - Pointer to table 


For Personal System/2 Model 25 and Model 30: 


(AL) = OOH - User alphanumeric load 
(BH) = 16 bytes per character for 400 scan lines 
(BL) - Block to be loaded 
(CX) - Count to be stored 
(DX) - Character offset into table 
(ES:BP) - Pointer to user table 


Note: If (BH) is set to 14 bytes per character for 400 scan lines, 
characters are extended to 16 high by extending the last 
line of 14-high characters. 


(AL) = 01H - Reserved 
(If this function is called, (AL) =04H is executed.) 


(AL) = 02H - ROM 8x8 double-dot font 
(BL) - Block to be loaded 


(AL) = 03H - Set block specifier (valid in alphanumeric modes) 
(BL) - Character-generator block selection 
If bit 3 of the character-attribute byte is set to 0, 
bits 1 and 0 of (BL) select a block from 0 to 3. 
If bit 3 of the character-attribute byte is set to 1, 
bits 3 and 2 of (BL) select a block from 0 to 3. 
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For example: 


¢ To set a 256-character set using block 2, set (BL) to hex 0A; 
this selects a single block. Bit 3 of the character-attribute 
byte turns the foreground intensity on or off. 


* To specify a 512-character set using blocks 0 and 2, set (BL) 
to hex 08; this selects block 0 when bit 3 of the 
character-attribute byte is set to 0, and it selects block 2 when 
bit 3 of the character-attribute byte is set to 1. 


If bits 1 and 0 and bits 3 and 2 are the same, only one block is 
selected, and bit 3 of the character-attribute byte turns the 
foreground intensity on or off. 


When the 512-character set is active, a function call with (AX) set 
to hex 1000 and (BX) set to hex 0712 is recommended to set the 
color registers with eight consistent colors. 


A block-specifier command must be issued after any 
character-load command to make the loaded block an active 
character set. 


(AL) = 04H - ROM 8x16 font 
(BL) - Block to be loaded 


The following register values are reserved. Calls to functions 
(AL) = 10H, 11H, 12H, and 14H are executed as if they were calls 
to (AL) =00H, 01H, 02H, and 04H, respectively. 


(AL) = 10H - Reserved 
(If this function is called, (AL}=O0H is executed.) 


(AL) = 11H - Reserved 
(If this function is called, (AL) =01H is executed.) 


{AL) = 12H - Reserved 
(If this function is called, (AL) = 02H is executed.) 


(AL) = 14H - Reserved 
(If this function is called, (AL) =04H is executed.) 


(AL) = 20H - Set user-graphics-characters pointer at Interrupt 1FH 
(ES:BP) - Pointer to user table 
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{AL) = 21H - Set user-graphics-characters pointer at Interrupt 43H 
(BL) - Row specifier 
= OOH - User 
(CX) - Points (bytes per character) 
(DL) - Rows 
= O1H - 14 (OEH) 
= 02H - 25 (19H) 
= 03H - 43 (2BH) 
(ES:BP) - Pointer to user table 


(AL) = 22H - Reserved 
(If this function is called, (AL) = 24H is executed.) 


(AL) = 23H - ROM 8x8 double-dot font 
(BL) - Row specifier 


(AL) = 24H ROM 8x16 font 
(BL) - Row specifier 


Note: (AL) = 20H, 21H, 22H, 23H, or 24H should be called only 


immediately after a mode setting is issued, or the results 
might be unpredictable. 


(AL) = 30H - Information 
(BH) - Font pointer 
= OOH - Return current Interrupt 1FH pointer 
O1H - Return current Interrupt 43H pointer 
02H - Reserved (if called, ROM 8x16 pointer is returned) 
03H - Return ROM 8x8 font pointer 
= O4H - Return ROM 8x8 font pointer (top) 
= 05H - Reserved 
= OGH - Return ROM 8x16 pointer 
= 07H - Reserved 


ond 


On Return: 
(CX) - Points 
(DL) - Rows (number of character rows on screen — 1) 
(ES:BP) - Pointer to table 


For all others, no action is performed. 
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(AH) = 12H—Alternative Selection 


For systems with EGA capability and Personal System/2 products 
except Model 25 and Model 30: 


(BL) = 10H - Return EGA information 
(BH) = 00H - Color mode in effect (3Dx address range) 
= 01H - Monochrome mode in effect (3Bx address range) 
(BL) - Memory value 
= OOH - 64KB 
01H - 128KB 
02H - 192KB 
03H - 256KB 
= 04H to FFH - Reserved 
(CH) = Adapter bits 
(CL) = Switch setting 


How ot it 


(BL) = 20H - Select alternative print-screen routine 


For Personal System/2 products except Model 25 and Model 30: 


(BL) = 30H - Select scan lines for alphanumeric modes (takes 
effect on the next mode setting) 
(AL) = 0- 200 scan lines 
1 - 350 scan lines 
2 - 400 scan lines 


On Return: 
(AL) = 12H - Function is supported 


(BL) = 31H - Default palette loading during mode setting 
(AH) = 00H 
(AL) = 0- Enable default palette loading 
= 1- Disable default palette loading 


On Return: 
(AL) = 12H - Function is supported 


Note: The EGA palette registers, the overscan register, and the 
color registers are not altered during any mode setting 
when they are disabled. 


(BL) = 32H - Video 
(AL) = 0 - Enable video 
= 1- Disable video 


On Return: 
(AL) = 12H - Function is supported 
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Note: Decoding of the video I/O port addresses and the 
regenerative buffer addresses is enabled or disabled for 
the display that is currently active. 


(BL) = 33H - Summing to gray shades 
(AL) = 0 - Enable summing 
= 1- Disable summing 


On Return: 
(AL) = 12H - Function is supported 


Note: When enabled, summing occurs when color registers are 
loaded through the Set Mode function ((AH) = 00H) and the 
Set Palette Registers function ((AH)= 10H). 


(BL) = 34H - Cursor emulation 
(AL) = 0 - Enable cursor emulation 
= 1- Disable cursor emulation 


On Return: 
(AL) = 12H - Function is supported 


Note: When enabled, the requested start or end value that is 
passed to the Set Cursor Type function ((AH) = 01H) is 
scaled to the current character height. The power-on 
default condition is for cursor emulation to be enabled. 


For Personal System/2 Model 25 and Model 30: 


(BL) = 20H - Select alternative print-screen routine 
(BL) = 30H - Reserved 


(BL) = 31H - Default palette loading during mode setting ((AH) = QOH) 
(AL) = 0 - Enable default palette loading 
= 1- Disable default palette loading (the 256 color 
registers are not altered during any mode setting 
when default palette loading is disabled) 


On Return: 
(AL) = 12H - Function is supported 


(BL) = 32H - Video I/O address and buffers 
(AL) = 0- Enable video I/O address and buffers 
= 1- Disable video {/O address and buffers 


On Return: 
(AL) = 12H - Function is supported 
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(BL) = 33H - Summing to gray shades 
(AL) = 0- Enable summing 
= 1- Disable summing 


On Return: 
(AL) = 12H - Function is supported 


(BL) = 34H - Reserved 


Note: When enabled, summing occurs when color registers are 
loaded through the Set Mode function ((AH) = 00H) and the 
Set Palette Registers function ((AH) = 10H). 


For Personal System/2 products: 


(BL) = 35H - Display switching 
(AL) = OOH - Initial adapter video off 
(ES:DX) - Pointer to 128-byte switch-state save area 
(AL) = O1H - Initial system-board video on 
(AL) = 02H - Switch active video off 
(ES:DX) - Pointer to switch-state buffer save area 
(AL) = 03H - Switch inactive video on 
(ES:DX) - Pointer to previously-saved switch-state buffer 


On Return: 
(AL) = 12H - Function is supported 


This interface enables display switching between a 
system-board-video driven display and an adapter-video driven 
display when there is overlap in the use of the BIOS data area 
and in hardware capabilities. 


Display switching requires that a disable function ((AH) = 12H, 
(BL) = 32H) be available for the system-board-video and 
adapter-video functions. 


If there is no conflict between the adapter video and the 
system-board video, both video functions are active in the 
system, and display switching is not required. 


If there is a conflict between the adapter video and the 
system-board video, the system-board video function is the 
primary video source. The adapter-video function remains 
disabled until it disables the system-board video and enables 
itself. 


When display switching is performed for the first time, the 
following steps are used: 


1. Call Initial Adapter Video Off ((AL) =OOH). 
2. Call Initial System-Board Video On ((AL) =01H). 
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These steps are valid only the first time switching is performed. 
After the initiation steps, switching between the system-board 
video and adapter video is performed through the Switch Active 
Video Off request ((AL) = 02H) and the Switch Inactive Video On 
request ((AL) =03H). 


When Switch Active Video Off ((AL) = 02H) is called, the 
currently-active video function and display are disabled. The 
switch-state buffer saves the video-state information, which is 
required when the display is reactivated through a Switch 
Inactive Video On ((AL) = 03H) request. 


When Switch Inactive Video On ((AL) =03H) is called, the 
currently-inactive video function and display are enabled. The 
switch-state buffer restores the video-state information, which 
was saved on a previous Switch Active Video Off ((AL) =02H) 
request for the display. 


Video Adapter 


If a video adapter supports display switching, it must perform the 
following steps. 


For Initial Adapter Video Off ((AL) = 00H), the adapter: 


1. Tests bit 6 at address hex 40:89 to ensure that the bit is set to 
0, which indicates that this is the first call. 

2. Issues Interrupt 42H with bit 7 in (AL) set to 1. Interrupt 42H 
activates display switching and sets bit 6 at address hex 40:89 
to 1. 

3. Tests bit 6 at address hex 40:89 to ensure that display 
switching is now active. 

4. Switches the active video off ((AL) = 02H). 


For Switch Active Video Off ((AL) =02H), the adapter: 


1. Tests bit 6 at address hex 40:89 to ensure that display 
switching is now active 

2. Disables the system interrupts 

3. Saves the BIOS data areas 

4. Swaps the active and inactive video vectors to pass control to 
the inactive video BIOS 

5. Disables the adapter 

6. Enables the system interrupts. 
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For Switch Inactive Video On ((AL) =03H), the adapter: 


1. Tests bit 6 at address hex 40:89 to ensure that display 
switching is now active 

. Disables the system interrupts 

. Restores the BIOS data areas 

. Enables the adapter 

. Enables the system interrupts. 


ah WN 


In addition, the following areas are affected by display switching: 


e Bits 5 and 4 of data area address hex 40:10 (installed 
hardware, video bits) 


¢ Data area addresses hex 40:49 to hex 40:66 (video-control 
data area 1) 


¢ Data area addresses hex 40:84 to hex 40:8A (video-control 
data area 2) 


¢ Pointer to video parameter table 

* fnterrupt 05H vector (print screen) 

¢ Interrupt 1DH vector (CGA video parameters) 

e Interrupt 1FH vector (upper 128 8x8 characters) 
e Interrupt 43H vector (graphics character table). 


For Personal System/2 products except Model 25 and Modei 30: 


(BL) = 36H - Video screen off or on 
(AL) = 0- Screen on 
= 1- Screen off 


On Return: 
(AL) = 12H - Function is supported 


For Personal System/2 Model 35 SX, Model 35 LS, Model 40 Sx, 
and Model 57 SX: 


(BL) = 37H - MFI alternative attribute set 
(AL) = 0- Disable MFI attributes 
= 1-€nable MFI attributes 
On Return: 
(AL) = 12H - Function is supported 


For all others, no action is performed. 
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(AH) = 13H—Write String 


For PG/XT BIOS dated 1/10/86 and later, AT, EGA, PC 
Convertible, and Personal System/2 products: 


(AL) = 00H 
(BL) - Attribute 
String: “char, char, char, ...”; 
the cursor is not moved 


(AL) = 01H 
(BL) - Attribute 
String: “char, char, char, ...”; 
the cursor is moved 


(AL) = 02H 
String: “char, attr, char, attr, ...”"; 
the cursor is not moved; valid for alphanumeric modes only 


(AL) = 03H 
String: “char, attr, char, attr, ...”; 
the cursor is moved; valid for alphanumeric modes only 


(BH) - Page number (0 based); see Figure 2-5 on page 2-iN10-3 for 
maximum pages 

(CX) - Character-only count 

(DX) - Position in which to begin string, in cursor terms 

(ES:BP) - Pointer to string to be written 


Note: Carriage Return, Line Feed, Backspace, and Bell are 
treated as commands, not as printable characters. 


For all others, no action is performed. 


(AH) = 14H—-Load LCD Character Font/Set LCD High-Intensity 
Substitute 


For PC Convertible: 


(AL) = 00H - Load user-specified font 

(BH) - Number of bytes per character (from 1 to 255), vaiue checked 
(BL) = 00H - Load main font (block 0) 

= O1H - Load alternative font (block 1) 

= 02H to FFH - No operation 
(CX) - Number of characters to be stored (from 1 to 256), 

value checked 
(DX) - Character offset into RAM font area 
(ES:DI) - Pointer to character font within user table where 
loading starts 


(AL) = 01H - Load system-ROM default font 
(BL) = OOH - Load main font (block 0) 
= 01H - Load alternative font (block 1) 
= 02H to FFH - No operation 
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(AL) = 02H - Set mapping of LCD high-intensity attribute 
(BL) = OOH - Ignore high-intensity attribute 
= 01H - Map high intensity to reverse image 
= 02H - Map high intensity to underscore 
= Q3H - Map high intensity to select alternative font 
= 04H to FFH - No operation 


(AL) = 03H to FFH - No operation 


For all others, no action is performed. 


(AH) = 15H—Return Physical-Display Parameters for Active Display 
For PC Convertible: 


On Return: 
(AX) - Alternative display-adapter type 
= 0- No alternative display adapter 
= §140-LCD 
= 5153 - CGA-type display 
= 5151 - Monochrome-type display 
(ES:Dl) - Points to table defined as follows: 
Word 1 - Display model number 
Word 2 - Number of vertical peis per meter 
Word 3 ~ Number of horizontal pels per meter 
Word 4 - Total number of vertical pels 
Word 5 - Total number of horizontal pels 
Word 6 - Horizontal pel separation, in micrometers 
(center to center) 
Word 7 - Vertical pel separation, in micrometers 
(center to center) 


The following figure lists the display types that are defined for the 
PC Convertible: 


LCD 
Monochrome LCD as CGA (Monochrome) 


5140H 5140H 
O8E1H 
0987H 
00C8H 
0280H 
01B8H 
019AH 


Figure 2-6. Display Types for PC Convertible 
For all others, no action is performed. 


(AH) = 16H to 19H—Reserved 
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(AH) = 1AH—Read/Write Display-Combination Code 
For Personal System/2 products: 


(AL) = OOH - Read display-combination code 


On Return: 
(AL) = 1AH - Function is supported (see display codes 
on page 2-IN10-29) 
(BH) - Alternative display code 
(BL) - Active display code 


(AL) = 01H - Write display-combination code (see display codes 
on page 2-IN10-29) 
(BH) - Alternative display code 
(BL) - Active display code 


On Return: 
(AL) = 1AH - Function supported 


Display Codes: 


OOH - No display 

01H - Monochrome with 5151 (monochrome) 

02H - CGA with 5153/5154 (color) 

03H - Reserved 

04H - EGA with 5153/5154 (color) 

05H - EGA with 5151 (monochrome) 

O6H - Professional Graphics System with 5175 (color) 

07H - Personal System/2 products, except Model 25 and Model 30, 
with monochrome display (for Model 25 and Modet 30, see 
display code 0BH) 

08H - Persona! System/2 products, except Model 25 and Model 30, 
with color display (for Model 25 and Model 30, see 
display code OBH) 

OSH to OAH - Reserved 

OBH - Personal System/2 products, except Model 25 and Model 30, 
video with analog monochrome 

OCH - Personal System/2 Model 25 and Model 30 video with analog 
color 

ODH to FEH - Reserved 


For all others, no action is performed. 


(AH) = 1BH—Return Functionality/State Information 
For Personal System/2 products: 


(BX) - implementation type 
(ES:Dl) - User-buffer pointer for return of information 


On Return: 
User buffer contains functionality/state information 
(AL) = 1BH - Function is supported 
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For implementation type hex 00: 


(BX) = 

(ES:DI) = papas size is hex 40 bytes 

(DI + 00H) word - Offset to static functionality information 
(DI + 02H) word - Segment to static functionality information 


Video states (the following information is dynamically generated 
and reflects the current video state): 


(DI+ 04H) byte - Video mode (see (AH) =00H on 
page 2-IN10-2 for supported modes) 
(DI + 05H) word - Columns on screen (character columns on screen) 
(DI + 07H) word - Length of regenerative buffer (in bytes) 
(Di + 09H) word - Starting address in regenerative buffer 
(DI + OBH) word - Cursor position for eight display pages 
(row, column) 
(DI + 1BH) word - Cursor-type setting (cursor start/end value) 
(DI+ 1DH) byte - Active display page 
(DI + 1EH) word - Display-controller address (38x — monochrome, 
3Dx — color) 
(DI+ 20H) byte - Current setting of 3x8 register 
(DI + 21H) byte - Current setting of 3x9 register 
(DI + 22H) byte - Rows on screen (character lines on screen) 
(Di + 23H) word - Character height (scan lines per character) 
(D1 + 25H) byte - Display-combination code (active) 
(DI + 26H) byte - Display-combination code (alternative) 
(Dl + 27H) word - Colors supported for current video mode 
(DI+ 29H) byte - Display pages supported for current video mode 
(Di +2AH) byte - Scan lines in current video mode 
= 0- 200 scan lines 
= 1-350 scan lines 
= 2- 400 scan lines 
= 3-480 scan lines 
= 4 to 255 - Reserved 
(Di + 2BH) byte - Primary character block (reserved on Personal 
System/2 Mode! 25 and Model 30) 
0- Block 0 
1- Block 1 
2 - Block 2 


bod 


= 255 - Block 255 
This information is based on the block specifier. See the 
Character Generator function ((AH) = 11H), (AL) = 03H. 
(DI+2CH) byte - Secondary character block (reserved on Personal 
System/2 Model 25 and Model 30) 
= 0- BlockO 
= 1- Block 1 
= 2- Block 2 


= 255 - Block 255 
This information is based on the block specifier. See the 
Character Generator function ((AH) = 11H), (AL) = 03H. 
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(Di+ 2DH) byte - Miscellaneous state information 
Bits 7, 6 - Reserved 
Bit 5 = 0 - Background intensity 
= 1- Blinking : 

Bit 4 = 1- Cursor emulation active (always set to 0 for 
Personal System/2 Model 25 and Model 30) 

Bit 3 = 1- Mode setting default palette loading disabled 

Bit 2 = 1- Monochrome display attached 

Bit 1 = 1- Summing active 

Bit 0 = 1- All modes on all displays active (always set to 
0 for Personal System/2 Model 25 and Model 30) 


(DI + 2EH) byte - Video that requires the video adapter interface 


driver to support modes outside of the current 
VGA range 
Bits 7 to 5 - Reserved 
Bit 4 = 0 - 132-column mode not supported 
= 1- 132-column mode supported 
Bit 3 = 0- VGA attributes set 
= 1- MFI attributes set 
Bit 2 = 0- 16-bit VGA graphics not present 
= 1- 16-bit VGA graphics present 
Bit 1 = 0- Al driver not required 
= 1-Al driver required 
Bit 0 = 0- BIOS does not support Al information return 
= 1-BiOS supports Al information return 
(DI + 2FH) byte - Reserved 
(DI+ 30H) byte - Reserved 
(DIl+ 31H) byte - Video memory available 
= 0-64KB 
1- 128KB 
2- 192KB 
3 - 256KB 
= 4to 255 - Reserved 
(DI+ 32H) byte - Save pointer-state information 
Bits 7, 6 - Reserved 
Bit 5 = 1- DCC extension active 
Bit 4 = 1- Palette override active 
Bit 3 = 1- Graphics font override active 
Bit 2 = 1- Alphanumeric font override active 
Bit 1 = 1- Dynamic save area active 
Bit 0 = 1-512-character set active 
(DI + 33H) to (DI+ 3FH) 13 bytes - Reserved 


Format of static functionality table: 
= 0 - Not supported 
= 1- Supported 


(00H) byte - Video modes 
Bit 7 = 1- Mode 07H 
Bit 6 = 1- Mode 06H 
Bit 5 = 1- Mode 05H 
Bit 4 = 1- Mode 04H 
Bit 3 = 1- Mode 03H 
Bit 2 = 1- Mode 02H 
Bit 1 = 1- Mode 01H 
Bit 0 = 1- Mode 00H 
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(01H) byte - Video modes 
Bit 7 = 1- Mode 0FH 
Bit 6 = 1- Mode 0EH 
Bit 5 = 1- Mode 0DH 
Bit 4 = 1- Mode 0CH 
Bit 3 = 1- Mode O0BH 
Bit 2 = 1- Mode 0AH 
Bit 1 = 1- Mode 09H 
Bit 0 = 1- Mode 08H 


(02H) byte - Video modes 
Bits 7 to 5 - Reserved 
Bit 4 = 1- Mode 14H 


Bit 3 = 1- Mode 13H 
Bit 2 = 1- Mode 12H 
Bit 1 = 1- Mode 11H 
Bit 0 = 1- Mode 10H 


See (AH) = 00H on page 2-IN10-2 for video mode 
information. 


(03H) to (07H) 4 bytes - Reserved 


(07H) byte - Scan lines available in text modes 
Bits 7 to 3 - Reserved 
Bit 2 = 400 scan lines 
Bit 1 = 350 scan lines 
Bit 0 = 200 scan lines 
See (AH) = 12H, (BL) =30H on page 2-IN10-22 for 
text-mode scan-line selection. 


(O8H) byte - Character blocks available in text modes 


(O9H) byte - Maximum number of active character blocks in text 
modes (see (AH) = 11H on page 2-IN10-14 for 
character-block loading interfaces) 


(OAH) byte - Miscellaneous functions 

Bit 7 = Color paging (always set to 0 for Personal System/2 
Model 25 and Model 30; see (AH) = 10H on page 2-IN10-10) 

Bit 6 = Color palette (see (AH) = 10H) 

Bit 5 = EGA palette (see (AH) = 10H) 

Bit 4 = Cursor emulation (see (AH) = 01H on page 2-IN10-6) 

Bit 3 = Mode-setting default-palette loading (see (AH) = 12H 
on page 2-IN10-22) 

Bit 2 = Character-font loading (see (AH) = 11H on page 2-IN10-14) 

Bit 1 = Summing (see (AH) = 10H and (AH) = 12H) 

Bit 0 = All modes on all displays (always set to 0 for 
Personal System/2 Model 25 and Model 30) 
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(OBH) byte - Miscellaneous functions 

Bits 7 to 4 - Reserved 

Bit 3 = DCC (see (AH) = 1AH on page 2-IN10-6) 

Bit 2 = Background intensity/blinking contro! (see (AH) = 10H 
on page 2-IN10-10) 

Bit 1 = Save/restore (always set to 0 for Personal System/2 
Model 25 and Model 30; see (AH) = 1CH on page 2-IN10-33) 

Bit 0 = Light pen (see (AH) = 04H on page 2-IN10-6) 


(OCH) to (ODH) 2 bytes - Reserved 


(OEH) byte - Save pointer functions 
Bits 7,6 = Reserved 
Bit 5 = DCC extension (always set to 0 for Personal System/2 
Model 25 and Model 30) 
Bit 4 = Palette override 
Bit 3 = Graphics font override 
Bit 2 = Alphanumeric font override 
Bit 1 = Dynamic save area 
Bit 0 = 512-character set 


(OFH) byte - Reserved 


For all others, no action is performed. 


(AH) = 1CH—Save/Restore Video State 
For Personal! System/2 products except Model 25 and Model 30: 


(AL) = 00H - Return save/restore state buffer size 
(CX) - Requested states (see supported save/restore 
states on page 2-IN10-34) 


On Return: 
(AL) = 1CH - Function is supported 
(BX) - Save/restore buffer-size block count (number of 
64-byte blocks for saving requested states in (CX)) 


(AL) = 01H - Save state 
(CX) = Requested states (see supported save/restore 
states on page 2-IN10-34) 
(ES:BX) - Buffer pointer to save state 


On Return: 
(AL) = 1CH - Function is supported 
The requested states are saved. 


(AL) = 02H - Restore state 
(CX) - Requested states (see supported save/restore 
states below) 
(ES:BX) - Buffer pointer to restore state 


On Return: 


(AL) = 1CH - Function is supported 
The requested states are restored. 
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Supported save/restore states: 
Bits 15 to 3 - Reserved and set to 0 
Bit 2 = 1- Save/restore video DAC state and color registers 
Bit 1 = 1- Save/restore video BIOS data area 
Bit 0 = 1- Save/restore video hardware state 


Note: The current video state is altered during the save-state 
operation. To maintain the current video state, perform a 
restore-state operation. 


For all others, no action is performed. 


(AH) =1DH to FFH—Reserved 
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Interrupt 11H—Equipment Determination 


This routine returns information about the optional devices that are 
attached to the system. 


BIOS data area hex 40:10 (installed hardware) is set during POST as 
follows: 


On Return: 
(AX) - Equipment flags 
Bits 15, 14 - Number of parallel ports 
Bit 13 = 1 - Internal modem installed (PC Convertible only) 
Bit 12 - Not used 
Bits 11 to 9 - Number of asynchronous communication ports 
Bit 8 - Not used 
Bits 7, 6 - Number of diskette drives installed, other than 
physical drive 0 (values are binary). These 
2 bits do not indicate the locations of the 
installed drives. 
= 00 - No other drives 
01-1 drives 
10 - 2 drives 
11-3 drives 
- Video mode type (values are binary) 
00 - Reserved 
01 - 40x25 (color) 
10 - 80x25 (color) 
11 - 80x25 (monochrome) 
Bit 3 - Not used 
Bit 2 = 1- Pointing device installed 
Bit 1 = 1- Math coprocessor installed 
Bit 0 = 0 - Diskette drive 0 is not present 
= 1- Diskette drive 0 is present 


Bits 5, 
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Notes: 
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Interrupt 12H—Memory Size Determination 


This routine returns the amount of RAM up to 640KB in the system as 
determined by POST, minus the memory that is allocated to the 
extended BIOS data area. See Interrupt 15H, Return Extended BIOS 
Data Area Segment Address function ((AH) =C1H) and Interrupt 15H, 
Extended-Memory Size Determination function ((AH) = 88H) for 
additional information. 


On return, (AX) contains the number of contiguous 1KB blocks of 
memory. 
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Notes: 
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Interrupt 13H—Diskette 


This interface provides access to diskette drives. The following is a 
summary of the diskette functions of Interrupt 13H. 


(AH) = 00H — Reset Diskette System 
(AH) = 01H — Read Status of Last Operation 
(AH) = 02H — Read Desired Sectors into Memory 
(AH) = 03H — Write Desired Sectors from Memory 
(AH) = 04H — Verify Desired Sectors 
(AH) = 05H — Format Desired Track 
(AH) = 06H to 07H — Reserved 
(AH) = 08H — Read Drive Parameters 
(AH) = O9H to 14H — Reserved 
(AH) = 15H — Read Diskette Drive Type 
(AH) = 16H — Diskette Change Line Status 
(AH) = 17H — Set Diskette Type for Format 
(AH) = 18H — Set Media Type for Format 
(AH) = 19H — Reserved 
|| (AH) = 20H — Get Media Type 
(AH) = 21H to FFH — Reserved 


Figure 2-7. INT 13H Diskette Functions 


Notes: 
1. All reserved input fields must be set to 0. 


2. For the diskette drive parameters, see the Diskette Drive 
Parameter Table in the “ROM Tables” section. 


For AT, PC/XT BIOS dated 1/10/86 and later, PC/XT Model 286, PC 
Convertible, and Personal System/2 products, operations that require 
the diskette-drive motor to be turned on call Interrupt 15H, Diskette 
Drive Motor Start function ((AX) =90FDH). This allows the operating 
system to perform a different task while waiting for the diskette-drive 
motor to accelerate. 


Before waiting for the diskette interrupt, BIOS calls Interrupt 15H, 
Device Busy function ((AH) = 90H) with (AL) =01H (Type = Diskette). 
This informs the operating system of the wait. The complementary 
Interrupt 15H, Interrupt Complete function ((AH) = 91H) with (AL) =01H 
(Type = Diskette) is called to indicate that the operation is complete. 
See “Multitasking Provisions” in the “Additional Information” section. 


| If the caller changes the values of the head settle time (byte 9) and 

| the motor startup time (byte 10) to values that are inconsistent with 

| the diskette drive specifications, BIOS enforces the minimum values 
| for these parameters as specified for the diskette drive. (For the 


Diskette—September 1991 2-IN13D-1 


= 
—s 
$9] 
a 
zx 
Cc 
ze) 
+ 
a 
ies) 
Tr 
Q 
n 
x 
o 
+ 
+ 
oO 


| diskette drive parameters, see the Diskette Drive Parameter Table in 
| the “ROM Tables” section.) The values of these parameters can be 

| increased to allow for correcting possible future problems if some 

| diskette drives require more than the nominal values for these 

| parameters. 


(AH) = 00H—Reset Diskette System 


(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 


On Return: 
(AH) - Status of operation 
= OOH - No error 
= O1H - Invalid diskette parameter 
02H - Address mark not found 
03H - Write-protect error 
= 04H - Requested sector not found 
= 06H - ‘Diskette change’ line active 
= 08H - DMA overrun on operation 
= 09H - DMA attempt across a 64KB boundary 
OCH - Media type not found 
10H - Cyclic redundancy check (CRC) error on diskette 
read 
20H - Genera! controller failure 
30H - Drive does not support media sense 
| = 31H - No media in drive 
| = 32H - Media type not supported by drive 
= 40H - Seek operation failed 
= 80H - Diskette drive not ready 
CF = 0- Status is 0 
= 1 - Status is non 0 


nol 


Address hex 40:41 is set to the status of operation. 


Notes: 


1. If the diskette BIOS reports an error, reset the diskette system 
and retry the operation. 


2. If the value in (DL) is greater than or equal to hex 80, the diskette 
system is reset, then the fixed-disk system is reset. The status 
returned in (AH) is the status of the fixed-disk reset. Read the 
status of the diskette system after completing the operation. 
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(AH) = 01H—Read Status of Last Operation 


(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 


On Return: 
(AH) - Status of operation (see values for the status of 
operation in (AH) = 00H on page 2-IN13D-2) 
CF = 0- Status is 0 
= 1- Status is nono 


(AH) = 02H—Read Desired Sectors into Memory 


{AL) - Number of sectors (not value checked) 
(CH) - Track number (not value checked; low 8 bits of 
10-bit track number, 0-based) 
(CL) - Bits 7, 6 - High 2 bits of 10-bit track number, 
0-based 
Bits 5 to 0 - Sector number (not value checked) 
(DH) - Head number (not value checked, 0-based) 
(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 
(ES:BX) - Address of buffer 


On Return: 
(AH) - Status of operation (see values for the status of 
operation in (AH) = 00H on page 2-IN13D-2) 
{AL) - Number of sectors actually transferred 
CF = 1- Status is nono 
= 0 - Status is 0 


Address hex 40:41 is set to the status of operation. 


Note: If the diskette BIOS reports an error, reset the diskette system 
and retry the operation. 


(AH) = 03H—Write Desired Sectors from Memory 


(AL) - Number of sectors (not value checked) 
(CH) - Track number (not value checked; low 8 bits of 
10-bit track number, 0-based) 
(CL) - Bits 7, 6 - High 2 bits of 10-bit track number, 
0-based 
Bits 5 to 0 - Sector number (not value checked) 
(DH) - Head number (not value checked, 0-based) 
(DL) - Drive number (0-based) 
Bit 7 = 0- Diskette (value checked) 
(ES:BX) - Address of buffer 


Diskette—September 1991 2-IN13D-3 


On Return: 
(AH) - Status of operation (see values for the status of 
operation in (AH) = 00H on page 2-IN13D-2) 
(AL) - Number of sectors actually transferred 
CF = 0 - Status is 0 
= 1- Status is nono 


Address hex 40:41 is set to the status of operation. 


Notes: 


1. If the diskette BIOS reports an error, reset the diskette system 
and retry the operation. 


2. For PC/XT Model 286, (AL) is not required. 


(AH) = 04H—Verify Desired Sectors 


(AL) - Number of sectors (not value checked) 
(CH) - Track number (not value checked; low 8 bits of 
10-bit track number, 0-based) 
(CL) - Bits 7, 6 - High 2 bits of 10-bit track number, 
0-based 
Bits § to 0 - Sector number (not value checked) 
(DH) - Head number (not value checked, 0-based) 
(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 
(ES:BX) - Address of buffer 


On Return: 
(AH) - Status of operation (see values for the status of 
operation in (AH) =00H on page 2-IN13D-2) 
(AL) - Number of sectors verified 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:41 is set to the status of operation. 


Notes: 


1. If the diskette BIOS reports an error, reset the diskette system 
and retry the operation. 


2. (ES:BX) is not required for AT BIOS dated 11/15/85 and later, 
PC/XT Model 286, PC Convertible, or Personal System/2 
products. 
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(AH) = 05H—Format Desired Track 


The buffer pointer (ES:BX) must point to the collection of desired 
address fields for the track. Each field has the following 4 bytes: 


Byte 0 - Track number 
Byte 1 - Head number 
Byte 2 - Sector number 
Byte 3 - Number of bytes per sector 
= 00H - Reserved 
= 01H - Reserved 
= 02H - 512 bytes per sector 
= 03H - Reserved 


There must be one entry for every sector on the track. This 
information is used to find the requested sector during read or write 
access. Before a diskette is formatted, if more than one format is 
supported for the drive that is being used, it is necessary to call 
Interrupt 13H, Set Diskette Type for Format function ((AH) = 17H) or 
Interrupt 13H, Set Media Type for Format function ((AH) = 18H) to 
specify the diskette type that is to be formatted. 


(AL) - Number of sectors (not value checked) 
(CH) - Track number (not value checked; low 8 bits of 
10-bit track number, 0-based) 
(CL) - Bits 7, 6 - High 2 bits of 10-bit track number, 
0-based 
Bits 5 to 0 - Not used 
(DH) - Head number (not value checked, 0-based) 
(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 
(ES:BX) - Address of buffer 


On Return: 
(AH) - Status of operation (see values for the status of 
operation in (AH) = 00H on page 2-IN13D-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:41 is set to the status of operation. 


Notes: 


1. If the diskette BIOS reports an error, reset the diskette system 
and retry the operation. 


2. The diskette drive parameter table is used to format the diskette. 
See the Diskette Drive Parameter Table in the “ROM Tables” 
section. 


3. For PC/XT Model 286, (AL) is not required. 
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(AH) = 06H to 07H—Reserved 
(AH) = 08H—Read Drive Parameters 


Each supported media type has a parameter table. 


For PCjr, PC, PC/XT, and for AT BIOS dated 1/10/84, this function 
is not supported: 
On Return: 
(AH) - Status of operation 
= 01H - invalid command 
CF = 1-Error 


Address hex 40:41 is set to the status of operation. 


For all others: 


(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 


On Return: 
(AH) = Status of operation 
(AL) = 0 
(BH) = 0 


(BL) - Bits 7 to 4 = 0 
Bits 3 to 0 - Valid drive type value in CMOS 

= 01H - 360KB, 5.25 inch, 40 track 
= 02H - 1.2MB, 5.25 inch, 80 track 
= 03H - 720KB, 3.5 inch, 80 track 

04H - 1.44MB, 3.5 inch, 80 track 

OSH - 720KB, 5.25 inch, 80 track 

= O6H - 2.88MB, 3.5 inch, 80 track 


Hou 


(KB = 1024 bytes; MB = 1 048 576 bytes.) 


(CH) - Maximum number of tracks (iow 8 bits of 10-bit track 
number, 0-based) 
(CL) - Bits 7, 6 - Maximum number of tracks (high 2 bits of 
10-bit track number, 0-based) 
- Bits 5 to 0 - Maximum sectors per track 

(DH) - Maximum head number 

(DL) - Number of diskette drives installed 

(ES:D!) - Pointer to 11-byte parameter table that is 
associated with the maximum supported media type 
within the drive (see the Diskette Drive Parameter 
Table in the “ROM Tables” section) 


All registers are returned as described above, except that (BL) is set 
to 0, when the drive type is known and any of the following conditions 
exists: 
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The CMOS type is invalid. 

The CMOS is not present. 

The CMOS battery is discharged. 
The CMOS checksum is invalid. 


If the requested drive is not installed, (AX), (BX), (CX), (DX), (Dl), and 
(ES) are set to 0. 


Address hex 40:41 is set to 0, and CF is set to 0. 


For drive number hex 80 or above (indicating fixed disks), this 
function is not supported: 


(AH) - Status of operation 
= 01H - Invalid command 
CF = 1- Error 


(ES), (AX), (BX), (CX), (DH), and (DI) are equal to 0, and (DL) contains 
the number of drives when any of the following conditions exists: 


¢ The drive number is invalid. 

e The drive type is unknown, and the CMOS is not present. 

¢ The CMOS battery is discharged, or the CMOS checksum is 
invalid. 

¢ The drive type is unknown, and the CMOS drive type is invalid. 


Address hex 40:41 is set to 0, and CF is set to 0. 


(AH) = 09H to 14H—Reserved 


(AH) = 15H—Read Diskette Drive Type 


For AT, PC/XT BIOS dated 1/10/86 and later, PC/XT Model 286, 
PC Convertible, and Personal System/2 products: 


(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 


On Return: 
(AH) = OOH - Drive not present 
= O1H - Diskette, no ‘diskette change’ line available 
02H - Diskette, ‘diskette change’ line available 
03H - Reserved 
CF = 0 - Operation successfully completed 


Address hex 40:41 is set to the status of operation. 
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For all others, this function is not supported: 


On Return: 
(AH) - Status of operation 
= O1H - Invalid command 
CF = 1- Error 


Address hex 40:41 is set to the status of operation. 


(AH) = 16H—‘Diskette Change’ Line Status 


For AT, PC/XT BIOS dated 1/10/86 and later, PC/XT Model 286, 
PC Convertible, and Personal System/2 products: 


(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 


On Return: 
(AH) = OOH - ‘Diskette change’ signal not active 
O1H - Invalid diskette parameter 
O6H - ‘Diskette change’ signal active 
= 80H - Diskette drive not ready 
CF = Oif (AH) is 0 
= 1 if (AH) is nonO 


il 


Address hex 40:41 is set to the value in (AH). 


For ail others, this function is not supported: 


On Return: 
CF = 1-Error 
(AH) - Status of operation 
= O1H - invalid command 


Address hex 40:41 is set to the status of operation. 


(AH) = 17H—Set Diskette Type for Format 


For AT, PC/XT BIOS dated 1/10/86 and later, PC Convertible, and 
Personal System/2 products: 


(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 
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(AL) = 00H - invalid request 
= 01H - Diskette 320/360KB in 360KB drive 
02H - Diskette 360KB in 1.2MB drive 
03H - Diskette 1.2MB in 1.2MB drive 
= 04H - AT BIOS before 6/10/85: Invalid request 
- All others: Diskette 720KB in 720KB drive 
= 05H to OFFH - Invalid request 


On Return: 
(AH) - Status of operation (see values for the status of 
operation in (AH) = 00H on page 2-IN13D-2) 
CF = 0 - Status is 0 
= 1- Status is nono 


Address hex 40:41 is set to the status of operation. 


For all others, this function is not supported: 


On Return: 
CF = 1-Error 
(AH) - Status of operation 
= 01H - Invalid command 


Address hex 40:41 is set to the status of operation. 


(AH) = 18H—Set Medla Type for Format 


For AT BIOS dated 11/15/85 and later, PC/XT BIOS dated 1/10/86 
and later, PC/XT Model 286, and Personal System/2 products, this 
function is called before Interrupt 13H, Format the Desired Track 
function ((AH) = 05H) is issued. If the diskette is changed, the 
function is called again. A diskette must be present in the drive. 


Each supported media type has a parameter table. 


(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 


(CH) - Number of tracks (low 8 bits of 10-bit track 
number, 0-based) 
(CL) - Bits 7, 6 - Number of tracks (high 2 bits of 
10-bit track number, 0-based) 
- Bits 5 to 0 - Sectors per track 


Diskette—September 1991 2-IN13D-9 


On Return: 

(ES:Dl) - Pointer to 11-byte parameter table for this 
media type, unchanged if (AH) is non 0 (see the Diskette 
Drive Parameter Table in the “Data Areas and ROM Tables” 
section) 

(AH) - Status of operation (see values for the status of 

operation in (AH) = 00H on page 2-IN13D-2) 

CF = 0- Status is 0 

= 1- Status is nono 


Note: For PC/XT Model 286 and Personal System/2 products, this 
function monitors the ‘diskette change’ signal. If the signal 
is active, BIOS attempts to reset the ‘diskette change’ line 
to the inactive state. If the attempt is successful (for 
example, when media is present), BIOS sets the correct 
data rate for formatting. If the attempt fails (for example, 
when no media is present), BIOS returns hex 80 in (AH) 
(Diskette Drive Not Ready), and the carry flag is set to 1. 


When the ‘diskette change’ signal is inactive, BIOS performs the 
function as requested. 


For all others, this function is not supported: 


On Return: 
(AH) - Status of operation 
= O1H - Invalid command 
CF = 1-Error 


Address hex 40:41 is set to the status of operation. 


(AH) = 19H—Reserved 


(AH) = 20H—Get Medla Type 


(DL) - Drive number (0-based) 
Bit 7 = 0 - Diskette (value checked) 


On Return: 
(AH) - Status of operation 
= 01H - Invalid request 
= 30H - Drive does not support media sense 
= 31H - No media in drive 
= 32H - Drive does not support media type 
(AL) - Type of media installed 
= 06H - 4MB diskette 
= 04H - 2MB diskette 
= 03H - 1MB diskette 
- All others are reserved 
CF = 0- Status is 0 
= 1- Status is non 0 
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(AH) = 21H to FFH—Reserved 
Supported Drives and Media 


Interrupt 13H supports the following drives. 


40 track One head 
| 40 track Two heads 
80 track Two heads 


80 track Two heads 
80 track Two heads 
80 track Two heads 


Figure 2-8. INT 13H Supported Diskette Drives 
Interrupt 13H supports the following media. 


40 track 8 sectors/track Double sided 
40 track 9 sectors/track Double sided 
80 track 15 sectors/track Double sided 


80 track 9 sectors/track Double sided 
80 track 18 sectors/track Double sided 
80 track 36 sectors/track Double sided 


| Figure 2-9. INT 13H Supported Media 
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Diskette Drive Parameters 


The following tables contain the recommended parameters for 
diskette drives that are supported on Personal System/2 products. 


Byte Definition 


First specification byte 
Second specification byte 
Motor-off time 

Bytes per sector 

Sectors per track 

Gap length 

Data length 

Gap length (format) 

Fill byte (format) 

Head settle time (in microseconds) 
Motor start (in “s-seconds) 
Maximum track numbers 
Data-transfer rate 
Multi-rate capability 


Byte Definition 


First specification byte 
Second specification byte 
Motor-off time 

Bytes per sector 

Sectors per track 

Gap length 

Data length 

Gap length (format) 

Fill byte (format) 

Head settle time (in microseconds) 
Motor start (in %-seconds) 
Maximum track numbers 
Data-transfer rate 
Multi-rate capability 


Figure 2-11. Media Parameter Table — 720KB Slimline Drive 
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Byte Definition 


First specification byte 
Second specification byte 
Motor-off time 

Bytes per sector 

Sectors per track 

Gap length 

Data length 

Gap length (format) 

Fill byte (format) 

Head settle time (in microseconds) 
Motor start (in “%*-seconds) 
Maximum track numbers 
Data-transfer rate 
Multi-rate capability 


Byte Definition 


First specification byte 
Second specification byte 
Motor-off time 

Bytes per sector 

Sectors per track 

Gap length 

Data length 

Gap length (format) 

Filt byte (format) 

Head settle time (in microseconds) 
Motor start (in %-seconds) 
Maximum track numbers 
Data-transfer rate 
Multi-rate capability 


Figure 2-13. Media Parameter Table — 1.44MB Slimline Drive 
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1.44M 2.88M 
Byte Definition Media Media 


First specification byte DOH AOH 
Second specification byte 02H 
Motor-off time 25H 
Bytes per sector 02H 
Sectors per track 24H 
Gap tength 38H 
Data length FFH 
Gap length (format) 53H 
Fill byte (format) F6H 
Head setile time (in microseconds) OFH 
Motor start (in %-seconds) 04H 
Maximum track numbers 4FH 
Data-transfer rate COH 
Multi-rate capability 02H 


1.44M 
Byte Definition Media 


First specification byte AOH 
Second specification byte 
Motor-off time 

Bytes per sector 

Sectors per track 

Gap length 

Data length 

Gap length (format) 

Fill byte (format) 

Head settle time (in microseconds) 
Motor start (in %-seconds) 
Maximum track numbers 
Data-transfer rate 

Multi-rate capability 


Figure 2-15. Media Parameter Table— 1.44MB Half-High Drive 
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Interrupt 13H—Fixed Disk 


This interface provides access to fixed disk drives. The following is a 
summary of the fixed disk functions of Interrupt 13H. 


(AH) = 00H — Reset Disk System 

(AH) = 01H — Read Status of Last Operation 

(AH) = 02H — Read Desired Sectors into Memory 
(AH) = 03H — Write Desired Sectors from Memory 
(AH) = 04H — Verify Desired Sectors 

(AH) = 05H ~— Format Desired Track 

(AH) = 06H ~ Format Desired Track and Set Bad-Sector Flags 
(AH) = 07H — Format Drive Starting at Desired Cylinder 
(AH) = 08H — Read Drive Parameters 

(AH) = 09H — Initialize Drive Pair Characteristics 
(AH) = OAH to OBH — Reserved 

(AH) = OCH — Seek 

(AH) = ODH — Alternative Disk Reset 

(AH) = OEH to OFH — Reserved 

(AH) = 10H — Test Drive Ready 

(AH) = 11H ~— Recalibrate 

(AH) = 12H to 14H — Reserved 

(AH) = 15H — Read DASD Type 

(AH) = 16H to 18H ~ Reserved 

(AH) = 19H — Park Heads 

(AH) = 1AH to 20H — Reserved 

(AH) = 21H — Read Multiple Sectors into Memory 
(AH) = 22H — Write Multiple Sectors from Memory 
(AH) = 23H — Reserved 

(AH) = 24H — Set Multiple Mode 

(AH) = 25H — Identify Drive 

(AH) = 26H to FFH — Reserved 


Figure 2-16. INT 13H Fixed Disk Functions 


Notes: 
1. All reserved input fields must be set to 0. 


2. If a fixed disk drive adapter is not installed, the code is not 
hooked into Interrupt 13H; the values that are returned are 
described in “Interrupt 13H—Diskette.” 


3. For the fixed disk interface, the drive number in (DL) is value 
checked for ail functions that use the device number. 


4. For AT, PG/XT Model 286, and Personal System/2 products, 
before waiting for this interrupt, BIOS calis Interrupt 15H, Device 
Busy function ((AH) = 90H) with (AL) = 00H (Type = Disk) to inform 
the operating system of the wait. The complementary Interrupt 
15H, Interrupt Complete function ((AH) =91H) with (AL) =00H 
(Type = Disk) is called to indicate that the operation is complete. 
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5. For Personal System/2 products, before waiting for the fixed disk 
reset, BIOS calls Interrupt 15H, Device Busy function ((AH) = 90H) 
with (AL) =FCH (Type= Fixed Disk Reset). This is a time-out-only 
function. There is no complementary power-on self-test (POST) 
operation. (See “Multitasking Provisions” in the “Additional 
Information” section.) 


6. Bit 7 of the drive number in (DL) must be set upon entry to the 
fixed disk BIOS. 


7. For the drive parameters see the Fixed Disk Drive Parameter 
Table in the “ROM Tables” section. 


(AH) = 00H—Reset Disk System 


(DL) - Drive number; bit 7= 1 for fixed disk drive (0-based) 


On Return: 

(AH) - Status of operation 

= OOH - No error 

01H - Unsupported function or parameter 
02H - Address mark not found 
03H - Write-protect error 
04H - Sector not found 
05H - Reset failed 
07H - Drive parameter activity failed 
08H ~ DMA overrun on operation 
09H - Data-boundary error 
OAH - Bad sector flag detected 
OBH - Bad cylinder detected 
ODH - Invalid number of sectors on format 
OEH - Control data address mark detected 
OFH - DMA arbitration level out of range 
10H - Uncorrectable error checking and correction (ECC) 

or cyclic redundancy check (CRC) error 
11H - ECC corrected data error 
12H - Command in progress 
13H - Device not powered-on 
20H - General controller failure 
40H ~- Seek operation failed 
80H - Time-out 
AAH - Drive not ready 
BBH - Undefined error occurred 
CCH - Write fault on selected drive 
EOH - Status error/error register =0 
FFH - Sense operation failed 
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CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 
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Notes: 


1. This function is issued only if the 7-bit drive number is tess than 
the maximum number of fixed disk drives that are installed. The 
diskette system is also reset for all values of (DL). 


2. For Personal System/2 products, before waiting for the fixed disk 
reset, BIOS calis Interrupt 15H, Device Busy function ((AH) = 90H) 
with (AL) =FCH (Type= Fixed Disk Reset) to inform the operating 
system of the wait. 


3. For Personal System/2 Model 35 SX, Model 35 LS, Model 40 SX, 
and Model L40 SX, both the master drive and the slave drive 
respond to the Reset function that is issued to either drive. Both 
drives are reset. 


(AH) = 01H—Read Status of Last Operation 


(DL) - Drive number; bit 7= 1 for fixed disk drive (0-based) 


On Return: 
(AH) - Status of this operation (see values for the status of 
operation on page 2-IN13F-2) 
(AL) - Status of the last operation 
CF = 0- Status is 0 
= 1- Status is non0 


Address hex 40:74 is set to 0. 


Note: This function returns the status of the last operation that was 
performed on the specified drive. The result is not valid if 
another drive has been accessed since the last operation was 
performed on the specified drive. 


(AH) = 02H—Read Desired Sectors Into Memory 


(AL) - Number of sectors 
(CH) - Cylinder number (low 8 bits of 10-bit cylinder number, 
0-based, not value checked) 

(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 

cylinder number, 0-based, not value checked) 
- Bits 5 to 0 - Sector number (not value checked) 

(DH) - Head number (0-based, not value checked) 

(DL) - Drive number; bit 7 = 1 for fixed disk drive (0-based) 

(ES:BX) - Address of buffer 
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On Return: 
(Ah) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


Notes: 


1. (AH) =11H indicates that the data that was read had a 
recoverable error that was corrected by the error checking and 
correction (ECC) aigorithm. The data is good; however, the BIOS 
routine indicates an error to notify the controlling program of the 
correction. The error might not recur if the data is rewritten. 


2. If the fixed disk BIOS reports an error, reset the disk system and 
retry the operation. 


(AH) = 03H—Write Desired Sectors from Memory 


(AL) - Number of sectors 
(CH) - Cylinder number (low 8 bits of 10-bit cylinder number, 
0-based, not value checked) 

(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 

cylinder number, 0-based, not value checked) 
- Bits 5 to 0- Sector number (not value checked) 

(DH) - Head number (0-based, not value checked) 

(DL) - Drive number; bit 7 =1 for fixed disk drive (0-based) 

(ES:BX) - Address of buffer 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


Note: If the fixed disk BIOS reports an error, reset the disk system 
and retry the operation. 
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(AH) = 04H—Verify Desired Sectors 


(AL) - Number of sectors 
(CH) - Cylinder number (iow 8 bits of 10-bit cylinder number, 
0-based, not value checked) 

(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 

cylinder number, 0-based, not value checked) 
- Bits 5 to 0 - Sector number (not value checked) 
(DH) - Head number (0-based, not value checked) 
(DL) - Drive number; bit 7 =1 for fixed disk drive (0-based) 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


Note: if the fixed disk BIOS reports an error, reset the disk system 


and retry the operation. 


(AH) = 05H—Format Desired Track 


(CH) - Cylinder number (low 8 bits of 10-bit cylinder number, 
0-based, not value checked) 
(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 
cylinder number, 0-based, not vaiue checked) 
- Bits 5 to 0 - Sector number (not value checked) 
(DH) - Head number (0-based, not value checked) 
(DL) - Drive number; bit 7 =1 for fixed disk drive (0-based) 


For PC/XT: 


(AL) - interleaving value 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 
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For AT, PC/XT Model 286, and Personal System/2 products: 


(ES:BX) - Address of buffer 


(ES:BX) points to a 512-byte buffer. The first 
[2 x (number of sectors per track)] bytes contain F and N 
for each sector, where 
F = 00H - Good sector 
= 80H - Bad sector 
N - Sector number 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


For any device that uses enhanced small device interface (ESDI) 
type or small computer system interface (SCSI) type commands, 
this function is not supported: 


On Return: 
(AH) - Status of operation 
= 01H - Invalid function request 
CF = 1- Error 


Address hex 40:74 is set to the status of operation. 


Note: if the fixed disk BIOS reports an error, reset the disk 
system and retry the operation. 
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(AH) = 06H—Format Desired Track and Set Bad-Sector Flags 
Warning: Formatting destroys all information on the fixed disk. 


For PC/XT: 


{AL) - Interleaving value 
(CH) - Cylinder number (low 8 bits of 10-bit cylinder number, 
0-based, not value checked) 

(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 

cylinder number, 0-based, not value checked) 
- Bits 5 to 0 - Sector number (not value checked) 
(DH) - Head number (0-based, not value checked) 
(DL) - Drive number; bit 7 = 1 for fixed disk drive (0-based) 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


For AT, PC/XT Model 286, Personal System/2 products, and any 
device that uses ESDI- or SCSI-type commands, this function is 
not supported: 


On Return: 
(AH) - Status of operation 
= 01H - invalid function request 
CF = 1- Error 


Note: If the fixed disk BIOS reports an error, reset the disk 
system and retry the operation. 
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(AH) = 07H—Format Drive Starting at Desired Cylinder 
For PC/XT: 


(AL) - Interleaving value 
(CH) - Cylinder number (low 8 bits of 10-bit cylinder number, 
0-based, not value checked) 
(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 
cylinder number, 0-based, not value checked) 
- Bits 5 to 0 - Sector number (not value checked) 
(DL) - Drive number; bit 7=1 for fixed disk drive (0-based) 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


For AT, PC/XT Model 286, Personal System/2 products, and any 
device that uses ESDI- or SCSI-type commands, this function is 
not supported: 


On Return: 
(AH) - Status of operation 
= 01H - Invalid function request 
CF = 1- Error 


Note: If the fixed disk BIOS reports an error, reset the disk 
system and retry the operation. 


(AH) = 08H—Read Drive Parameters 


lf the drive number is not valid, (AH) and address hex 40:74 are set to 
hex 07 (last fixed disk drive operation status), (CX) and (DX) are set to 
0, and CF is set to 1. If no fixed disk drive is attached or no fixed disk 
drive adapter is installed, (AH) and address hex 40:41 are set to hex 
01 (last diskette drive operation status), and CF is set to 1. 


(DL) - Drive number; bit 7 = 1 for fixed disk drive (0-based) 


On Return: 
(CH) - Maximum value for cylinder number (range is from 
Oto hex 3FFF) 
(CL) - Maximum value for sector and high-order 2 bits of 
cylinder numbers 
(DL) - Number of consecutive drives attached 
(DH) - Maximum value for head number (range is from 0 to hex 3F) 
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(AH) = 08H—Initialize Drive Pair Characteristics 


(DL) - Drive number; bit 7 = 1 for fixed disk drive (0-based) 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0 - Status is 0 
= 1- Status is non0 


For PC/XT: 


Interrupt 41H points to the parameter tables. Four entries in 
the PC/XT table correspond to the switch setting on the fixed 
disk drive adapter. The switches act as an index into the 
parameter table. For example, if both switches are set to the 
“on” position, the drive is initialized with the first entry of the 
parameter table. If the drive number is an allowable value 
(that is, 80H < (DL) < 87H), both drive 0 and drive 1 are 
initialized. For all other values, an unsupported-command 
status is returned. If drive 0 initialization fails, drive 1 
initialization is not attempted. If either attempt fails, address 
hex 40:74 (last fixed disk drive operation status) and (AH) are 
updated with the appropriate error code. 


For AT, PC/XT Model 286, and Personal System/2 products with 
Micro Channel’ architecture that do not have ESDI or SCSI: 


Interrupt 41H points to the single parameter table for drive 0, 
and Interrupt 46H points to the single parameter table for 
drive 1. If (DL) =80H, drive 0 is initialized through Interrupt 
41H. If (DL)=81H, drive 1 is initialized through Interrupt 46H. 
For all other values, an unsupported-command status is 
returned. 


“Micro Channel is a trademark of the International Business Machines Corporation. 
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For any device that uses ESDI- or SCSI-type commands: 


This function performs no action. Drive configuration 
information is obtained from the drive, not from a table in the 
system ROM. The controller automatically performs 
drive-type initialization. 


Note: If the fixed disk BIOS reports an error, reset the disk 
system and retry the operation. 


(AH) = OAH to OBH—Reserved 
(AH) = OCH~—Seek 


(CH) - Cylinder number (tow 8 bits of 10-bit cylinder number, 
0-based, not value checked) 
(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 
cylinder number, 0-based, not value checked) 
- Bits 5 to 0 - Sector number (not value checked) 
(DH) - Head number (0-based, not value checked) 
(DL) - Drive number; bit 7= 1 for fixed disk drive (0-based) 


On Return: 
(AH) - Status of operation (see vaiues for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is nono 


Address hex 40:74 is set to the status of operation. 


Note: [f the fixed disk BIOS reports an error, reset the disk system 
and retry the operation. 


(AH) = ODH—Alternative Disk Reset 


(DL) - Drive number; bit 7= 1 for fixed disk drive (0-based) 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0 - Status is 0 
= 1- Status is nono 


Address hex 40:74 is set to the status of operation. 
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Notes: 


1. The Alternative Disk Reset function is issued only if the 7-bit drive 
number is less than the maximum number of fixed disk drives 
that are installed. The diskette system is not reset. 


2. For Personal System/2 Model 35 SX, Model 35 LS, Model 40 SX, 
and Model L40 SX, both the master drive and the slave drive 
respond to the Reset function that is issued to either drive. Both 
drives are reset. 


(AH) = 0EH to OFH—Reserved 


(AH) = 10H—Test Drive Ready 


(DL) - Drive number; bit 7 =1 for fixed disk drive (0-based) 
On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0 - Status is 0 
= 1- Status is non0 


Address hex 40:74 is set to the status of operation. 


(AH) = 11H—Recalibrate 


(DL) - Drive number; bit 7 =1 for fixed disk drive (0-based) 
On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0 - Status is 0 
= 1- Status is nono 


Address hex 40:74 is set to the status of operation. 
Note: If the fixed disk BIOS reports an error, reset the disk system 
and retry the operation. 


(AH) = 12H to 14H~—Reserved 


Fixed Disk—September 1991 2-IN13F-11 


(AH) = 15H—Read DASD Type 


For PC/XT, this function is not supported: 


On Return: 
(AH) - Status of operation 


= 01H - Invalid function request 
CF = 1- Error 


Address hex 40:74 is set to the status of operation. 


For AT, PC/XT Model 286, and Personal System/2 products: 


(DL) - Drive number; bit 7= 1 for fixed disk drive (0-based) 
On Return: 


(CX,DX) - Number of 512-byte blocks 
DX - Least significant byte 
CX - Most significant byte 
If (AH) =0, (CX) =0 and (DX) =0 
(AH) = OOH - Drive not present or (DL) is not supported 
= 01H - Reserved 
02H - Reserved 
03H - Fixed disk 


yoieued 


CF = 0- Operation successfully completed 


Address hex 40:74 is set to the status of operation. 
(AH) = 16H to 18H—Reserved 
(AH) = 19H—Park Heads 


For PC/XT, AT, and PC/XT Model 286, this function is not 
supported: 


On Return: 
(AH) - Status of operation 


= 01H - Invalid function request 
CF = 1- Error 


Address hex 40:74 is set to the status of operation. 
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For Personal System/2 products except Model 35 SX, 
Model 35 LS, Model 40 SX, and Model L40 SX: 


(DL) - Drive number; bit 7=1 for fixed disk drive (0-based) 
On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


(AH) = 1AH to 20H—Reserved 


(AH) = 21H—Read Multiple Sectors into Memory 


For Personal System/2 Model 35 SX, Model 35 LS, Model 40 SX, 


and Mode! L40 Sx: 


(AL) - Number of sectors 
(CH) - Cylinder number (low 8 bits of 10-bit cylinder number, 
0-based, not vatue checked) 

(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 

cylinder number, 0-based, not value checked) 
- Bits 5 to 0 - Sector number (not value checked) 

(DH) - Head number (0-based, not value checked) 

(DL) - Drive number; bit 7=1 for fixed disk drive (0-based) 

(ES:BX) - Address of buffer 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


This function is exactly the same as the Read Desired Sectors 
into Memory function ((AH) = 02H) except for the way in which 
data transfers are performed. The unit of data transfer (block 
size) must be specified through the Set Multiple Mode function 


((AH) = 24H) before this function is called. 
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| (AH) = 22H—Write Multiple Sectors from Memory 


For Personal System/2 Model 35 SX, Model 35 LS, Model 40 SX, 
and Model L40 Sx: 


(AL) - Number of sectors 
(CH) - Cylinder number (low 8 bits of 10-bit cylinder number, 
0-based, not value checked) 

(CL) - Bits 7, 6 - Cylinder number (high 2 bits of 10-bit 

cylinder number, 0-based, not value checked) 
- Bits 5 to 0 - Sector number (not value checked) 

(DH) - Head number (0-based, not value checked) 

(DL) - Drive number; bit 7 = 1 for fixed disk drive (0-based) 

(ES:BX) - Address of buffer 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


This function is exactly the same as the Write Desired Sectors 
from Memory function ((AH) = 03H) except for the way in which 
data transfers are performed. The unit of data transfer (block 

| size) must be specified through the Set Multiple Mode function 
((AH) = 24H) before this function is called. 


(AH) = 23H—Reserved 


(AH) = 24H--Set Multiple Mode 


For Personal System/2 Model 35 SX, Model 35 LS, Model 40 SX, 
and Model L40 SX, this function specifies the number of sectors 
that are transferred by the Read Multiple Sectors into Memory 

| function ((AH) =21H) and the Write Multiple Sectors from Memory 
| function ((AH) = 22H). 


If the specified number of sectors is 0, the multiple-transfer mode 
is disabled. If an error is detected during execution of the Set 

| Multiple Mode function, the number of sectors is set to 0, which 

| causes the multiple-transfer mode to be disabled until the Set 
Multiple Mode function is called again. 
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(AL) - Block size (the number of sectors per interrupt that are 
transferred by multiple read or write operations) 
(DL) - Drive number; bit 7=1 for fixed disk drive (0-based) 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 


The maximum value for the block size depends on the fixed disk 
drive type. The value is stored in byte hex 15 of the fixed disk 
drive parameter table that is created by POST. 


(AH) = 25H—Identity Drive 


For Personal System/2 Model 35 SX, Model 35 LS, Model 40 Sx, 
and Model L40 SX: 


(DL) - Drive number; bit 7=1 for fixed disk drive (0-based) 
(ES:BX) - Address of buffer 


On Return: 
(AH) - Status of operation (see values for the status of 
operation on page 2-IN13F-2) 
CF = 0- Status is 0 
= 1- Status is non 0 


Address hex 40:74 is set to the status of operation. 
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The buffer stores 512 bytes of characteristic information for the 
fixed disk drive: 


= 
3 
a 


Definition 


General configuration 

Number of logical cylinder 

Reserved 

Number of logical cylinder 

Number of unformatted bytes per logical track 
Number of unformatted bytes per sector 
Number of iogical sectors per track 

Number of bytes in the inter-sector gaps 
Number of bytes in the Sync field 

Number of bytes of vendor-unique status 

Serial number (20 ASCII characters) 

Controller type 

Controlier-buffer size (in 512-byte increments) 
Number of ECC bytes passed on read/write long 
Controller-firmware revision (8 ASCII characters) 
Model number (40 ASCII characters) 

Number of sectors for multiple read/write 
Doubleword I/O capacity 

Programmable reallocation capacity 

50 to 255 Reserved 


OABANAAHWNH =O 


Figure 2-17. Fixed Disk Drive Identification Buffer 


(AH) = 26H to FFH—Reserved 
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Interrupt 14H—Asynchronous Communication 


These routines provide RS-232C support. The following is a summary 
of the RS-232C support functions of Interrupt 14H. 


(AH) = 00H — Initialize the Communication Port 
(AH) = 01H — Send Character 

(AH) = 02H — Receive Character 

(AH) = 03H — Read Status 


(AH) = 04H ~— Extended Initialization 
(AH) = 05H -— Extended Communication Port Control 
(AH) = O6H to FFH — Reserved 


Figure 2-18. INT 14H Asynchronous Communication Functions 
Note: All reserved input fields must be set to 0. 


(AH) = 00H—Initlalize the Communication Port 


(AL) - Parameters for initialization 
Bits 7 to 5 - Baud rate (values are binary) 
= 000 - 110 baud 
= 001 - 150 baud 


100 - 1200 baud 

101 - 2400 baud 

110 - 4800 baud 

111 - 9600 baud 
For Personal System/2 products, for baud rates 
above 9600, see Interrupt 14H, (AH) =04H and 
(AH) = 05H. 

Bits 4, 3 - Parity (values are binary) 
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= 11-Even 
Bit 2 - Stop bit 
0-1 
1-2 
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Bits 1, 0 - Data length (values are binary) 
= 00 - Reserved 
= 01 - Reserved 
= 10-7 bits 
= 11-8 bits 
(DX) - RS-232C communication line (0, 1, 2, or 3) to be 
used, corresponding to the actual port base addresses at 
address hex 40:00 


On Return: 

(AH) - Line status 
Bit 7 = 1-Time-out 
Bit 6 = 1- Transmitter shift register empty 
Bit 5 = 1- Transmitter holding register empty 
Bit 4 = 1- Break detection 
Bit 3 = 1- Framing error 
Bit 2 = 1 - Parity error 
Bit 1 = 1- Overrun error 
BitO = 1- Data ready 

(AL) - Modem status 
Bit 7 = 1- Receive line signal detection 
Bit 6 = 1- Ring indicator 
Bit 5 = 1- Data set ready 
Bit 4 = 1- Clear to send 
Bit 3 = 1- Delta receive line signal detection 
Bit 2 = 1- Trailing-edge ring detector 
Bit 1 = 1- Delta data set ready 
Bit 0 = 1- Delta clear to send 


Note: If bit 7 of the line-status byte is set to 1, settings of other bits 
are unpredictable. 


(AH) = 01H—Send Character 


(AL) - Character to be sent 

(DX) - RS-232C communication line (0, 1, 2, or 3) to be 
used, corresponding to actual port base addresses at 
address hex 40:00 


On Return: 
(AH) - Line status (see values for the line status on 
page 2-IN14-2) 
(AL) is preserved 
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(AH) = 02H—Recelve Character 


(DX) - RS-232C communication line (0, 1, 2, or 3) to be 
used, corresponding to actual port base addresses at 
address hex 40:00 


On Return: 
(AH) - Line status (see values for the line status on 


Page 2-IN14-2) 
(AL) - Character that was received 


Notes: 


1. The routine waits for the character. 


2. If bit 7 of the line status byte is set to 1, settings of other bits are 


unpredictable. 


(AH) = 03H—Read Status 


(DX) - RS-232C communication line (0, 1, 2, or 3) to be 
used, corresponding to actual port base addresses at 
address hex 40:00 


On Return: 
(AH) - Line status (see values for the line status on 
Page 2-IN14-2) 
(AL) - Modem status (see values for the modem status on 
page 2-IN14-2) 


(AH) = 04H—Extended Initialization 
For Personal System/2 products: 


(AL) - Break 
= OOH - No break 
= OTH - Break 
(BH) - Parity 
= OOH - None 
O1H - Odd 
02H - Even 
= 03H - Stick parity odd 
= O4H - Stick parity even 
(BL) - Stop bit 
= 00H-1 
= 01H - If the data-bit length is 6, 7, or 8 bits, the 
stop-bit length is 2 bits. 
If the data-bit length is 5 bits, the stop-bit 
length is 1% bits. 
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(CH) - Data-bit length 
= 00H - 5 bits 
= 01H - 6 bits 
= 02H -7 bits 
= O3H - 8 bits 
(CL) - Baud rate 
= QOH - 110 baud 
= O1H - 150 baud 
= 02H - 300 baud 
= 03H - 600 baud 
= 04H - 1200 baud 
= 05H - 2400 baud 
= 06H - 4800 baud 
= 07H - 9600 baud 
= O8H - 19200 baud 
= 09H - 31250 baud 
(DX) - RS-232C communication line (0, 1, 2, or 3) to be 
used, corresponding to actual port base addresses at 
address hex 40:00 


On Return: 
(AH) - Line status (see values for the line status on 
page 2-IN14-2) 
(AL) - Modem status (see values for the modem status on 
page 2-IN14-2) 


For all others, no action is performed. 


(AH) = 05H—Extended Communication Port Control 
For Personal System/2 products: 


(AL) = OOH - Read modem-control register 
(DX) - RS-232C communication line (0, 1, 2, or 3) to be 
used, corresponding to actual port base addresses at 
address hex 40:00 


On Return: 

(BL) - Modem-control register 
Bits 7 to 5 - Reserved 
Bit 4 = 1- Loop 
Bit3 = 1- Out2 
Bit 2 = 1- Outt 
Bit 1 = 1- Request to send 
Bit 0 = 1 - Data terminal ready 
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(AL) = O1H - Write modem-control register 
(BL) - Modem-control register 
Bits 7 to 5 - Reserved 


Bit 4 = 1-Loop 
Bit 3 = 1- Out2 
Bit 2 = 1-Out1 


Bit 1 = 1- Request to send 
Bit 0 = 1- Data terminal ready 
(DX) - RS-232C communication line (0, 1, 2, or 3) to be 
used, corresponding to actual port base addresses at 
address hex 40:00 


On Return: 
(AH) - Line status (see values for the line status on 
page 2-IN14-2) 


(AL) - Modem status (see values for the modem status on 
Page 2-IN14-2) 


For all others, no action is performed. 
(AH) = 06H to FFH—Reserved 


Programming Consideration 


| If the communication line that is specified in (DX) does not have a 
| corresponding port base address at hex 40:00, the function is not 


| executed, and it does not return an error to the caller. 
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Notes: 
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Interrupt 15H—System Services 


The following is a summary of the system services of Interrupt 15H. 


00H — Turn Cassette Motor On 

01H — Turn Cassette Motor Off 

02H ~ Read Blocks from Cassette 

03H — Write Blocks to Cassette 

04H — Build System Parameters Table 

05H — Build Initialization Table 

O6H to OEH — Reserved 

OFH — Format-Unit Periodic Interrupt 

10H to 20H — Reserved 

21H — Power-On Self-Test Error Log 

22H — ROM BASIC Support 

23H — Reserved 

24H — A20 Gate Support 

25H to 3FH — Reserved 

40H — Read/Modify Profiles 

41H — Wait for External Event 

42H — Request System Power-Off 

43H — Read System Status 

44H — Activate/Deactivate Internal Modem Power 
45H to 4EH — Reserved 

4FH — Keyboard Intercept 

(AH) = 50H — Reserved 

(AH) = 51H — Expansion-Unit Information 

(AH) = 52H to 7FH — Reserved 

(AH) = 80H — Device Open 

(AH) = 81H — Device Close 

(AH) = 82H — Program Termination 

(AH) = 83H — Event Wait 

(AH) = 84H — Joystick Support 

(AH) = 85H — System Request Key Pressed 

(AH) = 86H ~— Wait 

(AH) = 87H — Move Block 

(AH) = 88H — Extended-Memory Size Determination 
(AH) = 89H — Switch Processor to Protected Mode 
(AH) = 8AH to 8FH — Reserved 

(AH) = 90H — Device Busy 

(AH) = 91H — Interrupt Complete 

(AH) = 92H to BFH — Reserved 

(AH) = COH — Return System Configuration Parameters 
(AH) = C1H — Return Extended BIOS Data Area Segment Address 
(AH) = C2H — Pointing Device BIOS Interface 

(AH) = C3H — Enabie/Disable Watchdog Time-Out 
(AH) = C4H — Programmable Option Select 

(AH) = C5H to C6H — Reserved 


[| | | 
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Figure 2-19 (Part 1 of 2). INT 15H System Services Functions 
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C7H — Return Memory-Map Information 
C8H — Enable/Disable Processor Functions 
C9H — Processor Type and Stepping Level 

CAH to CDH — Reserved 

CEH — Allocate Arbitration Level 
CFH — Deallocate Arbitration Level 
DOH — Reserved 

(AH Dit — Return Device Descriptor Table (DDT) Information 

(AH D2 

(AH D4 

(AH D 

(AH D 

(AH D 


H to DSH — Reserved 

H — Return Physical Fixed Disk Drive Number (Selectable Boot) 
5H — Reserved 
6H — Return Boot Device ID and Key 
7H to FFH — Reserved 


ann add u tna ‘ : tl 


Figure 2-19 (Part 2 of 2). INT 15H System Services Functions 
Note: All reserved input fields must be set to 0. 
(AH) = 00H—Turn Cassette Motor On 

For PCjr and PC: 


On Return: 
(AH) = 00H 
CF=0 


For all others, this function is not supported: 
On Return: 


(AH) = 86H 
CF = 1 


(AH) = 01H—Turn Cassette Motor Off 
For PCjr and PC: 
On Return: 
(AH) = 00H 
CF =0 
For all others, this function is not supported: 
On Return: 


(AH) = 86H 
CF = 1 
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(AH) = 02H—Read Blocks from Cassette 
For PCjr and PC: 


(CX) - Count of bytes to be read 
(ES:BX) - Pointer to data buffer 


On Return: 
(DX) - Count of bytes read 
(ES:BX) - Pointer to last byte that was read + 1 
CF = 0- Operation successfully completed 
= 1- Operation failed 
For PCjr, when CF =1: 
(AH) = 01H - CRC error 
= 02H - Lost data transitions 
= 04H - No data found 


For all others, this function is not supported: 


On Return: 
(AH) = 86H 
CF =1 


(AH) = 03H—Write Blocks to Cassette 
For PCjr and PC: 


(CX) - Count of bytes to be written 
(ES:BxX) - Pointer to data buffer 


On Return: 
(CX) = 00H 
(ES:BX) - Pointer to last byte that was written + 1 
CF = 0 - Operation successfully completed 
= 1 - Operation failed 
For PCjr, when CF =1: 
(AH) = O1H - CRC error 
= 02H - Lost data transitions 
= 04H - No data found 


For all others, this function is not supported: 


On Return: 
(AH) = 86H 
CF = 1 
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(AH) = 04H—Bulld System Parameters Table 


See “Build System Parameters Table—Operating System” and “Build 
| System Parameters Table—BiOS” in the Advanced BIOS 
“Initialization” section. 


(AH) = 05H—Build Initialization Table 
See “Build Initialization Table—Operating System” and “Build 


Initialization Table—BIOS” in the Advanced BIOS “Initialization” 
section. 


(AH) = OFH—Format-Unit Periodic Interrupt 
For any device that uses ESDI-type commands: 


(AL) - Phase code 
= OOH - Reserved 
= 01H - Surface analysis 
= 02H - Formatting 


On Return: 


CF = 0- Continue formatting or scanning 
= 1- End formatting or scanning 


Note: This function provides a hook to the caller when the 
formatting or scanning of each cylinder is complete. If no 
handler is hooked, CF is set to 1 on return. 


For PCjr and PC, this function is not supported: 
On Return: 
(AH) = 80H 
CF =1 
For all others, this function is not supported: 
On Return: 


(AH) = 86H 
CF=1 


(AH) = 10H to 20H—Reserved 
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(AH) = 21H—Power-On Self-Test Error Log 


| This function reads from and writes to the power-on self-test (POST) 
| error log area, which is used to communicate POST errors to the 
| operating system. 


For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF = 1 


For Personal System/2 products except Model 25 and Model 30: 


(AL) = OOH - Read POST error log 


On Return: 
(BX) - Number of POST error codes that were stored 
(ES:Dl) - Pointer to POST error log 
(AH) = 00H 
CF=0 


(AL) = 01H - Write error code to POST error log 
(BX) - POST error code (word) 
(BH) - Device code 
(BL) - Device error 


On Return: 
(AH) = 00H - Successfully stored 
= O1H - Error code location full 
CF = 0 - Successfully stored 
= 1- Error code location full 


For all others, this function is not supported: 


On Return: 
(AH) = 86H 
CF = 1 


(AH) = 22H—-ROM BASIC Support 


On Return: 
(ES:BX) - Pointer to ROM BASIC. 
CF = 0 - Operation successfully completed 
= 1- Request failed 
(AH) - Return code 
= 00H - Operation successfully completed 
= 86H - Function not supported (ROM BASIC is at 
address hex F600:0000) 
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(AH) = 23H—Reserved 


(AH) = 24H—A20 Gate Support 


(AL) = OOH - Disable A20 gate 


On Return: 
(AH) - Return code 
= 00H - Operation successfully completed 
= 01H - Keyboard controller is in secure mode 
= 86H - Function not supported 
CF = 0- Operation successfully completed 
= 1- Operation failed 


(AL) = 01H - Enable A20 gate 


On Return: 
(AH) - Return code 
= OOH - Operation successfully completed 
= 01H - Keyboard controller is in secure mode 
= 86H - Function not supported 
CF = 0- Operation successfully completed 
= 1- Operation failed 


(AL) = 02H - Query status of A20 gate 


On Return: 

(AL) - Status of A20 gate 
= OOH - Disabied 
= 01H - Enabled 

(AH) - Return code 
= OOH - Operation successfully completed 
= 01H - Keyboard controller is in secure mode 
= 86H - Function not supported 

CF = 0- Operation successfully completed 

= 1- Operation failed 


(AL) = 03H - Query A20 gate support 


On Return: 
(BX) - Status of A20 gate support 
Bit 15 = 0 - No additional data available 
= 1- All bits in register are used; 
additional data is available (location 
of additional data is to be determined) 
Bit 1 = 0 - Not supported with bit 1 of port hex 92 
= 1- Supported with bit 1 of port hex 92 
Bit 0 = 0 - Not supported on keyboard controller 
= 1- Supported on keyboard controller 
(AH) - Return code 
= OOH - Operation successfully completed 
= Q1H - Keyboard controller is in secure mode 
= 86H - Function not supported 
CF = 0- Operation successfully completed 
= 1- Operation failed 
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(AH) = 25H to 3FH—Reserved 


(AH) = 40H—Read/Modity Profiles 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF=1 


For PC Convertible: 


(AL) = OOH - Read system profile 


On Return: 
(CX,BX) - Profile information 


(AL) = 01H - Modify system profile 
(CX,BX) - Profile information 


(AL) = 02H - Read internal modem profile 


On Return: 
(BX) - Profile information 


(AL) = 03H - Modify internal modem profile 
(BX) - Profile information 


On Return for all: 
(AL) = 00H - Operation successfully completed 
= 80H - Profile execution failed 
CF = 0- Operation successfully completed 
= 1- Operation failed 


For all others, this function is not supported: 
On Return: 


(AH) = 86H 
CF =1 


(AH) = 41H—Wait for External Event 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF =1 
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For products that support this function: 


(AL) - Event-type code 
= 00H - Return after any event has occurred 
= 01H - Compare values, return if equal 
02H - Compare values, return if not equal 
03H - Test bit, return if not 0 
= 04H - Test bit, return if 0 
(BH) - Condition compare or mask value 
(BL) - Time-out value (in 55-millisecond units) 
= 0- No time-out 
(ES:DI) - Pointer to byte in user area for event 
determination (event-type codes 01H to 04H) 
—~or— 
- (DX) contains the I/O port address to be read 
for event determination (event-type codes 11H 
to 14H) 


tq 


On Return: 
CF = 1- Time-out 


Notes: 


1. Event type codes (AL) =11H, 12H, 13H, and 14H are the same 
as codes (AL)=01H, 02H, 03H, and 04H, respectively, except 
that (DX) is used to contain the event determination address. 


2. To determine which products support this function, see 
Interrupt 15H, Return System Configuration Parameters 
function ((AH) = COH), feature information byte 1, bit 3. 


For all others, this function is not supported: 


On Return: 
(AH) = 86H 
CF =1 


(AH) = 42H—Request System Power-Off 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF =1 
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For PC Convertible: 


(AL) = OOH - Use system profile for suspend/IPL determination 
(AL) = O1H - Force system suspend mode, regardless of profile 


On Return: 
(AX) is modified 


For all others, this function is not supported: 


On Return: 
(AH) = 86H 
CF = 1 


(AH) = 43H—Read System Status 
For PCjr and PC: 


On Return: 
CF=1 
(AH) = 80H 


For PC Convertible: 


On Return: 

(AH) is modified 

(AL) - Status 
Bit 7 - Low battery indication 
Bit 6 - Operating on external power source 
Bit 5 - Standby power lost (real-time clock time bad) 
Bit 4 - Power activated by real-time clock alarm 
Bit 3 - internal modem power-on 
Bit 2 - RS-232C/parallel power-on 
Bit 1 - Reserved 
Bit 0 - LCD detached 


For all others, this function is not supported: 
On Return: 


(AH) = 86H 
CF =1 
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(AH) = 44H—Activate/Deactivate Internal Modem Power 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF=1 


For PC Convertible: 


(AL) = 00H - Power-off internal modem 
(AL) = 01H - Power-on internal modem and configure according 
to system profile 


On Return: 
(AL) = 00H - Operation successfully completed 
= 80H - Operation failed 
CF = 0- Operation successfully completed 
= 1- Operation failed 


For ali others, this function is not supported: 
On Return: 


(AH) = 86H 
CF =1 


(AH) = 45H to 4EH—Reserved 
(AH) = 4FH—Keyboard Intercept 
For PCjr and PC, this function is not supported: 
On Return: 


(AH) = 80H 
CF =1 


For PC/XT BIOS dated 11/8/82 and AT BIOS dated 1/10/84, this 
function is not supported: 
On Return: 


(AH) = 86H 
CF=1 
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For all others, Interrupt 09H (Keyboard) calls the keyboard 
intercept (keyboard escape) to allow the keystroke to be changed 
or absorbed. Normally, the system returns the scan code 
unchanged, but the operating system can point Interrupt 15H to 
itself and do one of the following: 


1. Replace (AL) with a different scan code and return the carry 
flag set to 1, effectively changing the keystroke. 


2. Process the keystroke and return with the carry flag reset, 
causing Interrupt 09H to ignore the keystroke. 


(AL) - Scan code 
CF=1 


On Return: 
CF=1 
(AL) - New scan code 
-or- 
CF=0 
(AL) - Unchanged scan code 


Note: To determine which products support this function, see 
Interrupt 15H, Return System Configuration Parameters 
function ((AH) =COH), feature information byte 1, bit 4. 


(AH) = 50H to 7FH—Reserved 
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(AH) = 51H—Expansion-Unit Information 


(AL) = 01H - Return configuration number 


On Return: 


(AL) - Current configuration number 
= 00H - System unit only 


= FFH - Configuration not recognized 
(BX) - Status flag 


Bit 15 = 0 - No additional configuration information is available 
= 1- Additional configuration intormation is available 


(the access method is to be determined) 
Bits 14 to 0 - Reserved 


(Ah) - Return code 
= OOH - Operation successfully completed 
= 01H - Expansion unit is not present 
86H - Function not supported 
CF = 0- Operation failed 
= 1- Operation successfully completed 


(AH) = 80H—Device Open 


For PCjr and PC, this function is not supported: 
On Return: 


(AH) = 80H 
CF =1 


For PC/XT BIOS dated 11/8/82, this function is not supported: 


On Return: 
(AH) = 86H 
CF = 1 


For all others: 
(BX) - Device ID 
(CX) - Process ID 
(AH) = 81H~—Device Close 


For PCjr and PC, this function is not supported: 
On Return: 


(AH) = 80H 
CF =1 
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For PC/XT BIOS dated 11/8/82, this function is not supported: 


On Return: 
{AH) = 86H 
CF =1 


For all others: 
(BX) - Device ID 


(CX) - Process ID 


(AH) = 82H—Program Termination 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF = 1 


For PC/XT BIOS dated 11/8/82, this function is not supported: 


On Return: 
(AH) = 86H 
CF =1 
For ali others: 


(BX) - Device ID 


(AH) = 83H—Event Walt 
For PCjr and PC, this function is not supported: 
On Return: 
(AH) = 80H 
CF=1 
For PC/XT, this function is not supported: 
On Return: 


(AH) = 86H 
CF=1 
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For AT BIOS dated 1/10/84: 


(CX,DX) - Microseconds until posting 
(granularity is 976 microseconds) 
(ES:BX) - Pointer to byte in caller’s memory that has the 
high-order bit set by BIOS as soon as possible 
after the interval expires 


On Return: 
CF = 0- Operation successfully completed 
= 1 - Operation failed; function busy 


For all others: 


(AL) = OOH - Set interval 
(ES:8X) - Pointer to byte in caller’s memory that has the 
high order bit set by BIOS as soon as possible 
after the interval expires 
(CX,DX) - Microseconds until posting 
(granularity is 976 microseconds) 


On Return: 
CF = 0- Operation successfully completed 
= 1- Operation failed, function busy 
(AL) = O1H - Cancel set interval 


On Return: 
CF = 0- Operation successfully completed 


(Personal System/2 Model 25 and Model 30 always return with CF = 1.) 


(AH) = 84H—Joystick Support 
For PCjr, PC, and PC Convertible, this function is not supported: 
On Return: 
(AH) = 80H 
CF =1 
For PC/XT BIOS dated 11/8/82, this function is not supported: 
On Return: 


(AH) = 86H 
CF =1 
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For all others: 


(DX) = 00H - Read current switch settings 


On Return: 
(AL) - Switch settings (bits 7 to 4) 
CF = 1- Invalid call 


(DX) = O1H - Read resistive inputs 


On Return: 
(AX) - Joystick A, x value 
(BX) - Joystick A, y value 
(CX) - Joystick B, x value 
(DX) - Joystick B, y value 
CF = 1- Invalid call 


(AH) = 85H—System Request Key Pressed 
For PC/r and PC, this function is not supported: 


On Return: 
{AH) = 80H 
CF =1 


For PC/XT BIOS dated 11/8/82, this function is not supported: 


On Return: 
(AH) = 86H 
CF=1 
For all others: 
(AL) = OOH - Key make 
(AL) = 01H - Key break 
(AH) = 86H—Walt 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF =1 
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For PC/XT, this function is not supported: 


On Return: 
(AH) = 86H 
CF =1 


For all others: 


(CX,DX) - Time before return to caller, in microseconds 
(granularity is 976 microseconds) 


On Return: 
CF = 0- Successful wait 
= 1- Wait function already in progress 


(AH) = 87H—Move Block 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF=1 


For PC/XT, PC Convertible, and Personal System/2 Model 25 and 
Model 30, this function is not supported: 


On Return: 
(AH) = 86H 
CF =1 


For AT, PC/XT Model 286, and Personal System/2 products except 
Model 25 and Model 30, this function allows a real-mode program 
or system to transfer a block of data to and from storage above 
the 1MB protected-mode address range by switching to the 
protected mode. 


(CX) - Word count of storage block to be moved 
(maximum count = 8000H for 32KB words [65KB]) 
(ES:S]) - Location of a global descriptor table (GDT) that was 
built by a routine that is using this function 


(ES:SI) points to a global descriptor table (GDT) that was built 
before this function was called. The descriptors are used to 
perform the block move in the protected mode. The source and 
target descriptors that are built by the user must have a segment 
length equal to or greater than 2 x ((CX)—1). The data-access 
rights byte must be set to current privilege level 0 with read/write 
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access (hex 93). The 24-bit address (byte high, word low) must 
be set to the target or source. 


Note: No interrupts are allowed during transfers. Large block 
moves might cause lost interrupts. 


On Return: 
(AH) = OOH - Operation successfully completed 
(AH) = 01H - RAM parity (parity error registers cleared) 
(AH) = 02H - Other exception interrupt error occurred 
(AH) = 03H - Gate address line 20H failed; all registers except (AH) 
are restored 


{f (AH) = OOH: 
CF=0 
ZF = 1 

If (AH) = 01H to 03H: 
CF=1 
ZF=0 


The following figure shows the organization of a block-move 
global descriptor table (GDT). 


(ES:SI)—>-> +00 


7 
[ss 


Figure 2-20. Block Move Global Descriptor Table 


+08 
+10 
+18 
+20 


+28 
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The following is the format of the global descriptor table (the 
actual location that is pointed to by (ES:SI)): 


BLOCKMOVE_GDT_DEF STRUC 


DW 0,0,0,0 ; First descriptor not accessible 
CGDT_LOC DW ?,2,2,0 ; Location of calling routine GDT 
SOURCE DW ?,7,7,0 ; Source descriptor 
TARGET DW ?2,7,7,0 ; Target descriptor 
BIOS_CS DW ?,7,2,0 ; BIOS code descriptor 
TEMP_SS DW 2,7,7,0 ; Stack descriptor 


BLOCKMOVE_GDT_DEF ENDS 


Figure 2-21. Global Descriptor Table Format 


The descriptors are defined as follows: 


¢ The first descriptor is the required dummy and is 
user-initialized to 0. 


¢ The second descriptor points to the GDT as a data segment. 
It is user-initialized to 0 and can be modified by BIOS. 


¢ The third descriptor points to the source to be moved and is 
user-initialized (see Figure 2-22 on page 2-IN15-19). 

The fourth descriptor points to the destination segment and is 
user-initialized (see Figure 2-22 on page 2-IN15-19). 


¢ The fifth descriptor is used by BIOS to create the 
protected-mode code segment. It is user-initialized to 0 and 
can be modified by BIOS. 


¢ The sixth descriptor is used by BIOS to create a 
protected-mode stack segment. It is user-initialized to 0, can 
be modified by BIOS, and points to the user stack. 
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The following is an example of a source or target descriptor: 


SOURCE_TARGET_DEF STRUC 


SEG_LIMIT DW ? ; Segment limit (1 to 65536 bytes) 
LO_WORD DW 2 ; 24-bit segment physical 
HI_BYTE DB ? ; address (0 to [16MB—1]) 
DATA_ACC_RIGHTS DB 93H ; Access rights byte (CPL 0—R/W) 
Reserved DW 0 ; Reserved word (must be 0) 


SOURCE_TARGET_DEF ENDS 


Figure 2-22. Source or Target Descriptor Example 


(AH) = 88H—Extended-Memory Size Determination 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF = 1 


For PC/XT, PC Convertible, and Personal System/2 Model 25 and 
Model 30, this function is not supported: 


On Return: 
(AH) = 86H 
CF = 1 


For 80286-, 80386-, and 80486-processor systems, this function 
returns the amount of system memory that is between addresses 
hex 100000 and hex FFFFFF, as determined by POST. 


On Return: 
(AX) - Contiguous 1KB blocks of available memory between 
addresses hex 100000 and hex FFFFFF (1MB to 16MB) 


Note: The Return Memory-Map Information function 
((AH) = C7h), if it is supported, returns the complete 
memory information. 


(AH) = 89H—Switch Processor to Protected Mode 
For PCjr and PC, this function is not supported: 
On Return: 


(AH) = 80H 
CF =1 
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For PC/XT, PC Convertible, and Personal System/2 Model 25 and 
Modei 30, this function is not supported: 


On Return: 
(AH) = 86H 
CF=1 


For AT, PC/XT Model 286, and Personal System/2 products except 
Model 25 and Model 30, this function allows the user to switch the 
system microprocessor into the protected (virtual address) mode. 
When this function is compieted, the system microprocessor is in 
the protected mode, and control is transferred to the code 
segment that is specified by the user. 


The entry requirements are as follows: 


e (ES:SI) points to a global descriptor table (GDT) that was built 
before this function was called. These descriptors initialize 
the interrupt descriptor table (IDT) register, the GDT register, 
and the stack segment (SS) selector. The data segment (DS) 
selector, the extra segment (ES) selector, and the code 
segment (CS) selector are initialized from descriptors that 
were built by the routine that is using this function. 


¢ (BH) contains an index into the interrupt descriptor table that 
indicates where the first eight hardware interrupts begin 
(interrupt level 1). (BL) contains an index into the interrupt 
descriptor table that indicates where the second eight 
hardware interrupts begin (interrupt level 2). 
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The following figure shows the organization of the selectors in 
this GDT; the actual location is pointed to by (ES:SI). 


(ES:SI)—>—> +00 
+08 
+10 
+18 
+20 
+28 
+30 


+38 


Temporary BIOS CS 


Figure 2-23. Global Descriptor Table 
Each descriptor must contain the limit, the base address, and the 
access-rights byte. The descriptors are defined as follows: 


¢ The first descriptor is the required dummy and is 
user-initialized to 0. 


¢ The second descriptor points to the GDT as a data segment 
and is user-initialized. 


¢ The third descriptor points to the user-defined interrupt 
descriptor table (IDT) and is user-initialized. 


¢ The fourth descriptor points to the user data segment (DS) 
and is user-initialized. 


¢ The fifth descriptor points to the user extra segment (ES) and 
is user-initialized. 


¢ The sixth descriptor points to the user stack segment (SS) 
and is user-initialized. 


* The seventh descriptor points to the user code segment (CS) 
that this function returns to. It is user-initialized. 


* The eighth descriptor is used to establish a code segment for 
itself. This is necessary for this function to complete its 
operation while the system microprocessor is in the 
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Con 


The 


protected mode. When control is passed to the user code, 
this descriptor can be reused. 


(AH) = 89H 
(ES:S!) - Location of GDT built by a routine that is 
using this function 


On Return: 
(AH) = OOH - Operation successfully completed 


All segment registers are changed; (AX) and (BP) are modified. 


siderations: 


BIOS functions are not available to the user. The user must 
handle all I/O commands. 


Interrupt vector locations must be moved, because of the 
80286 reserved areas. 


The hardware interrupt controllers must be reinitialized to 
define locations that do not reside in the 80286 reserved 
areas. 


An exception interrupt table and handler must be initialized 
by the user. 


The interrupt descriptor table cannot overlap the real-mode 
BIOS interrupt descriptor table. 


following is an example of a way to switch the system 


microprocessor to the protected (virtual address) mode: 


~ User code - 

MOV AX, gdt segment 

MOV ES, AX 

MOV SI, gdt offset 

MOV BH, hardware interrupt level 1 offset into IDT 
MOV BL, hardware interrupt level 2 offset into IDT 
MOV AH, 89H 

INT 15H 

- User code - 

(Protected mode established) 
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The following is the format of the global descriptor table (the 
actual location that is pointed to by (ES:SI)). 


VIRTUAL_ENABLE_GDT_DEF STRUG 


DW 0,0,0,0 ; First descriptor not accessible 
GOTPTR_DW DW 2,7,7,0 ; GDT descriptor 
IOTPTR DW 2,7,7,0 ; IDT descriptor 
USER_DS DW 2,2,2,0 ; User data segment descriptor 
USER_ES DW 2,?,27,0 ; User extra segment descriptor 
USER_SS DW 2,2,7,0 ; User stack segment descriptor 
USER_CS DW ?,2,2,0 ; User code ségment descriptor 
BIO_CS DW 2,2,7,0 ; Temporary BIOS descriptor 


VIRTUAL_ENABLE_GDT_DEF ENDS 


Figure 2-24. Global Descriptor Table Format 
(AH) = 8AH to 8FH—Reserved 


(AH) = 90H—Device Busy 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF =1 


For PC/XT BIOS dated 11/8/82, this function is not supported: 


On Return: 
(AH) = 86H 
CF = 1 


For all others, this function is called to tell the operating system 
that the system is about to wait for a device. 


The type-code assignments for (AH) = 90H and (AH) = 91H use the 
following general guidelines: 


¢ Type codes hex 00 to hex 7F are for seriaily-reusable devices 
(the operating system must serialize access). 


* Type codes hex 80 to hex BF are for reentrant devices. 
(ES:BX) is used to distinguish between different calls 
(multiple I/O calls are allowed simultaneously). 


¢ Type codes hex CO to hex FF are for wait-only calls. There is 
no complementary posting for these waits. These are 
time-out only. Times are function-number dependent. 
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(AL) - Type code 

= 00H - Disk (time-out) 

= 01H - Diskette (time-out) 

= 02H - Keyboard (no time-out) 

= 03H - Pointing device (time-out) 

= 80H - Network (no time-out) 
(ES:BX) - Network control block (NCB) 

= FCH - Fixed disk reset for Personal System/2 products only 
(time-out) 

= FDH - Diskette drive motor start (time-out) 

= FEH - Printer (time-out) 


On Return: 
CF = 0- Wait not satisfied 
= 1- Minimum wait time satisfied for 
this type code 


(AH) = 91H—Interrupt Complete 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF = 1 


For PC/XT BIOS dated 11/8/82, this function is not supported: 


On Return: 
(AH) = 86H 
CF = 1 


For all others, the interrupt-complete flag is set to tell the 
operating system that the interrupt has occurred. 


(AL) - Type code (see the type codes for the Device Busy function 
((AH) = 80H) on page 2-IN15-24) 


(AH) = 92H to BFH—Reserved 


(AH) = COH—Return System Configuration Parameters 


To obtain a complete Micro Channel configuration table, the 


Return Memory-Map Information function ((AH) = C7H), the 


Processor Type and Stepping Level function ((AH) = C9H), and the 


Return Device Descriptor Table (DDT) Information function 


((AH) = D1H) must be called in addition to the Return System 


Configuration Parameters function ((AH) = COH). 
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For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF=1 


For PC/XT BIOS dated 11/8/82 and AT BIOS dated 1/10/84, this 
function is not supported: 


On Return: 
(AH) = 86H 
CF =1 


For AT BIOS dated 6/10/85 and later, PC/XT BIOS dated 1/10/86 
and jater, PC/XT Model 286, PC Convertible, and Personal 
System/2 products: 


On Return: 
(ES:BX) - Pointer to system configuration parameter table 
(AH) = 0 
CF =0 


System configuration parameters: 


DW XXXX Length of table (in bytes) 
DB XX Model byte 

DB XX Submodel byte 

DB XX BIOS revision level 

DB XX Feature information byte 1 


Bit 7 = 0 - Fixed-disk BIOS does not use 
DMA channel 3 or channel-3 
usage cannot be determined 

= 1- Fixed-disk BIOS uses DMA 
channel 3 (not used in 
Micro Channel systems) 

Bit 6 = 0- Second interrupt chip is not 

present 
= 1- Second interrupt chip is 
present 

Bit 5 = 0- Real-time clock is not present 

= 1- Real-time clock is present 

Bit 4 = 0- Keyboard escape sequence 
{Interrupt 15H, (AH) = 4FH) is 
not called in Keyboard interrupt 
(09H) 

= 1- Keyboard escape sequence is 
called in Keyboard interrupt 
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Bit 3 = 0 - Wait for External Event function 
(Interrupt 15H, (AH) = 41H) is not 
supported 

= 1- Wait for External Event function 
is supported 

Bit 2 = 0 - Extended BIOS data area is not 
allocated 

= 1- Extended BIOS data area is 
allocated 

Bit 1 = 0 - PC-type I/O channel is 
implemented 

= 1 - Micro Channel bus is implemented 

Bit 0 = 0 - System does not have dual-bus 

capability 
= 1- System has dual-bus capability 
DB XX Feature information byte 2 

Bit 7 - Reserved 

Bit 6 = 0 - Keyboard Functionality 
Determination function 
(interrupt 16H, (AH) = 09H) is not 
supported 

= 1- Keyboard Functionality 
Determination function is 
supported 

Bit 5 = 0 - Return POS Data function 
(Interrupt 15H, (AH) = C6H) is not 
supported 

= 1- Return POS Data function is 
supported 

Bit 4 = 0 - Return Memory-Map Information 
function (Interrupt 15H, (AH) = C7H) 
is not supported 

= 1- Return Memory-Map Information 
function is supported 

Bit 3 = 0 - Enable/Disable Processor Functions 
function (Interrupt 15H, (AH) = C8H) 
is not supported 

= 1- Enabie/Disable Processor Functions 
function is supported 

Bit 2 = 0 - 8042 keyboard controller is in the 
system 

= 1- Non-8042 keyboard controller is in 
the system 

Bit 1 = 0 - Data streaming is not supported 

= 1- Data streaming is supported 

Bit 0 - Reserved 

DB XX Feature information byte 3 

Bits 7 to 4 - Reserved 

Bit 3 = 0 - SCSI subsystem is not supported on 
the system board 

= 1- SCSI subsystem is supported on 
the system board 

Bit 2 = 0 - Information panel is not installed 

= 1- Information panel is installed 

Bit 1 = 0- Non-IML system 

= 1- IML system 
Bit 0 = 0- No SCSI support in IML 
= 1- SCSI support in IML 
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DB XX Feature information byte 4 
Bits 7 to 0 - Reserved 

DB XX Feature information byte 5 
Bits 7 to 0 - Reserved 


Note: For Personal System/2 products except Model 25 and 
Model 30, if the system model cannot be determined, this 
function returns (AH) =86H and CF=1, and (ES:BX) is not 
changed. 


(AH) = C1H—Return Extended BIOS Data Area Segment Address 


On Return: 
(ES) - Extended BIOS data area segment address 
CF = 0-No error 
= 1-Error 


For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF=1 


For PG/XT, AT, PC/XT Model 286, and PC Convertible, this 
function is not supported: 


On Return: 
(AH) = 86H 
CF =1 


(AH) = C2H—Pointing-Device BIOS Interface 


(AL) = 00H - Enable/disable pointing device 
(BH) = OOH - Disable 
= 01H - Enable 


On Return: 

(AH) - Status 
= OOH - No error 
= 01H - Invalid function cal! 
= 02H - Invalid input 
= 03H - interface error 
= 04H - Resend 
= 05H - No far cail installed 

CF = 0- Operation successfully completed 

= 1- Operation failed 
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(AL) = 01H - Reset pointing device 


On Return: 
(BL) - Value returned by the attached device after reset 
{(BL) is set to hex AA if the device is a mouse) 
(AH) - Status (see return for (AL) = 00H) 
CF = 0- Operation successfully completed 
= 1- Operation failed 


If the operation is successfully completed: 
(BH) - Device ID 
= 00H 
The pointing-device state is as follows: 
— Disabled 
— Sample rate of 100 reports per second 
— Resolution of 4 counts per millimeter 
— Scaling of 1:1 
— Data package size remains the same as before this 
function was called 


(AL) = 02H - Set sample rate 
(BH) - Sample rate value 
= OOH - 10 reports per second 
= 01H - 20 reports per second 
= 02H - 40 reports per second 
= 03H - 60 reports per second 
= 04H - 80 reports per second 
= 05H - 100 reports per second 
= O6H - 200 reports per second 


On Return: 
(AH) - Status (see return for (AL) =O0H) 
CF = 0- Operation successfully completed 
= 1- Operation failed 


(AL) = 03H - Set resolution 
(BH) - Resolution value 
= OOH - 1 count per millimeter 
= O1H - 2 counts per millimeter 
= 02H - 4 counts per millimeter 
= 03H - 8 counts per millimeter 


On Return: 
(AH) - Status (see return for (AL) = 00H) 
CF = 0- Operation successfully completed 
= 1- Operation failed 


(AL) = 04H - Read device type 


On Return: 
{AH) - Status (see return for (AL) = 00H) 
CF = 0- Operation successfully completed 
= 1- Operation failed 


If the operation is successfully completed: 


(BH) - Device ID 
= 00H 
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(AL) = 05H - Pointing-device interface initialization 
(BH) - Data package size 
= 00H - Reserved 


= 02H - 2 bytes 
= 03H - 3 bytes 
= 04H - 4 bytes 
= 05H - 5 bytes 
= 06H - 6 bytes 


= 08H - 8 bytes 


On Return: 
(AH) - Status (see return for (AL) = 00H) 
CF = 0- Operation successfully completed 
= 1- Operation failed 


The pointing-device state is as follows: 
— Disabled 
— Sample rate of 100 reports per second 
~— Resolution of 4 counts per millimeter 
— Scaling at 1:1 


(AL) = O6H - Extended commands 
(BH) = OOH - Return status 


On Return: 

(AH) - Status (see return for (AL) = 00H) 

CF = 0 - Operation successfully completed 
= 1- Operation failed 


if the operation is successfully completed: 
(BL) - Status byte 1 
Bit 7 = 0 - Reserved 
Bit 6 = 0 - Stream mode 
= 1- Remote mode 
Bit 5 = 0- Disable 
= 1- Enable 
Bit 4 = 0- 1:1 scaling 
= 1- 2:1 scaling 
Bit 3 = 0 - Reserved 
Bit 2 = 1 - Left button pressed 
Bit 1 = 0- Reserved 
Bit 0 = 1 - Right button pressed 


(CL) - Status byte 2 
= 00H - 1 count per millimeter 
= 01H - 2 counts per millimeter 
= 02H - 4 counts per millimeter 
= 03H - 8 counts per millimeter 
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(DL) - Status byte 3 

= OAH - 10 reports per second 
14H - 20 reports per second 
28H - 40 reports per second 
3CH - 60 reports per second 
= 50H - 80 reports per second 
= 64H - 100 reports per second 
= C8H - 200 reports per second 


ion ll 


(BH) = 01H - Set scaling to 1:1 


On Return: 

(AH) - Status (see return for (AL) = 00H) 

CF = 0- Operation successfully completed 
= 1- Operation failed 


(BH) = 02H - Set scaling to 2:1 


On Return: 

(AH) - Status (see return for (AL) =00H) 

CF = 0- Operation successfully completed 
= 1- Operation failed 


(AL) = 07H - Device-driver far-call initialization 
(ES) - Segment 
(BX) - Offset 


On Return: 
(AH) - Status (see return for (AL) = 00H) 
CF = 0 - Operation successfully completed 
= 1- Operation failed 


For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF = 1 


For PG/XT, AT, PC/XT Model 286, and PC Convertible, this 
function is not supported: 


On Return: 
(AH) = 86H 
CF=1 
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The user codes a routine to receive control when the 
pointing-device data is available. The device-driver far-call 
initialization communicates the address of this routine to the 
BIOS. Each time the pointing-device data is available, the 
pointing-device interrupt handter calls the user routine, with the 
following parameters on the stack: 


Status - First word pushed on the stack 

X data - Second word pushed on the stack 
Y data - Third word pushed on the stack 

Z data - Fourth word pushed on the stack 


Word 1 on the stack: 
Low byte - Status 
Bit 7 - Y data overflow 
= 1- Overflow 
Bit 6 - X data overflow 
= 1- Overflow 
Bit 5 - ¥Y data sign 
= 1- Negative 
Bit 4 - X data sign 
= 1- Negative 
Bit 3 - Reserved (must be set to 1) 
Bit 2 - Reserved (must be set to 0) 
Bit 1 - Right-button status 
= 1- Pressed 
Bit 0 - Left-button status 
= 1- Pressed 
High byte = 0 


Word 2 on the stack: 
Low byte - X data 
Bit 7 = Most-significant bit 
Bit 0 - Least-significant bit 
High byte = 0 


Word 3 on the stack: 
Low byte - Y data 
Bit 7 = Most-significant bit 
Bit 0 - Least-significant bit 


High byte = 0 
Word 4 on the stack: 

Low byte = 0 

High byte = 0 


The pointing-device interrupt handler uses a far call to transfer 
control to the user routine. This routine should be coded as a far 
procedure and should not pop the parameters off the stack before 
returning. 
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(AH) = C3H—Enable/Disable Watchdog Time-Out 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF=1 


For PC/XT, AT, PG/XT Model 286, PC Convertible, and Personal 
System/2 Model 25 and Model! 30, this function is not supported: 


On Return: 
(AH) = 86H 
CF =1 


For Personal System/2 products except Model 25 and Model 30: 


(AL) = 00H - Disable the PS/2* watchdog timer 
= 01H - Enable the PS/2 watchdog timer 
= 02H - Disable the Gearbox* system 
= 03H - Enable the Gearbox system 


(BX) - Watchdog timer count (values from 1 to 255 are 
valid for Personal System/2 products) 


On Return: 


CF = 0- Operation successfully completed 
= 1- Operation failed or function not supported 


(AH) = C4H—Programmable Option Select (POS) 
For PCjr and PC, this function is not supported: 


On Return: 
(AH) = 80H 
CF =1 


* 


PS/2 and Gearbox are trademarks of the International Business Machines 
Corporation. 


2-IN15-32 System Services—September 1991 


For PC/XT, AT, PC/XT Model 286, PC Convertible, and Personal 
System/2 Model 25 and Model 30, this function is not supported: 


On Return: 
(AH) = 86H 
CF=1 


For Personal System/2 products except Model! 25 and Model 30: 


(AL) = OOH - Return base POS-adapter-register address 


On Return: 
(DX) - Base POS-adapter-register address 
CF = 0- Operation successfully completed 
= 1- Operation failed or function not supported 


(AL) = O1H - Enable selected slot for setup cycles 
(BL) - Slot number 


On Return: 
CF = 0- Operation successfully completed 
= 1- Operation failed or function not supported 


(AL) = 02H - Disable setup cycles for all slots 


On Return: 
CF = 0- Operation successfully completed 
= 1- Operation failed or function not supported 


| The following is the procedure for reading the POS registers for all 
| slots in the system: 


1. Call the Return Base POS Adapter Register Address function 


((AL) =00H). (Examine the return code and carry flag after each 
BIOS cali.) 


2. Call the Enable Selected Slot for Setup Cycles function 
((AL) =01H) with (BL) set to 1 to put slot 1 into setup mode. 


adapter register address. 
4. Repeat steps 2 and 3 (with the slot number in (BL)) for each slot. 


5. Call the Disable Setup Cycles for All Slots function ((AL) = 02H) to 


| 
| 
| 
| 
| 
| 3. Read the POS registers for slot 1, beginning with the base POS 
| 
| 
| 
| take all slots out of setup mode. 


| For additional information about the POS adapter registers, see the 
| “Programmable Option Select” section in the Personal System/2 
| Hardware Interface Technical Reference. 


(AH) = CSH to C6H—Reserved 
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(AH) = C7H—Return Memory-Map Information 


To obtain a complete Micro Channel configuration table, the 
Return System Configuration Parameters function ((AH)=COH), 
the Processor Type and Stepping Levei function ((AH) =C9H), and 
the Return Device Descriptor Table (DDT) Information function 
((AH) = D1H) must be called in addition to the Return 
Memory-Map Information function ((AH) =C7H). 


This function is not supported on all systems. If the function is 
not supported, the carry flag is set to 1, and the value that is 
returned in (AH) is either hex 80 (for PCjr and PC) or hex 86. 


(DS:SI) - Pointer to the user-supplied memory-map table 
with a minimum length of 66 bytes 


On Return: 
(AH) = 80H or 86H - Function not supported 
CF = 0- Operation successfully completed 
= 1- Operation failed or function not supported 


The word at offset hex 00 is the number of bytes that make up the 
rest of the table; the minimum value is hex 42 (decimal 66). 
Memory values are expressed as the number of 1KB blocks. 


Memory-map table structure: 


Size Offset Description 

Word 00H Number of significant bytes of returned data 
(excluding this word) 

DWord 02H Amount of local memory between 1MB and 16MB, 
in 1KB blocks 

DWord 06H Amount of local memory between 16MB and 4GB, 
in 1KB blocks 

DWord OAH Amount of system memory between 1MB and 16MB, 
in 1KB blocks 

DWord OEH Amount of system memory between 16MB and 4GB, 
in 1KB blocks 

DWord 12H Amount of cacheable memory between 1MB and 
16MB, in 1KB blocks 

OWord 16H Amount of cacheable memory between 16MB and 
4GB, in 1KB blocks 

OWord 1AH Number of 1KB blocks before the start of 
non-system memory between 1MB and 16MB 

DWord 1EH Number of 1KB blocks before the start of 
non-system memory between 16MB and 4GB 

DWord 22H to 2AH Reserved 
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The various memory types are defined as follows: 


Local memory 


Channel memory 


System memory 


Non-system memory 


Memory on the system board or memory 
that is not accessible from the channel. It 
can be system or non-system memory. 


Memory on adapters. It can be system or 
non-system memory. 


Memory that is managed and allocated by 
the primary operating system. This 
memory is cached if the cache is enabled. 


Memory that is not managed or allocated 
by the primary operating system. This 
memory includes memory-mapped I/O 
devices; memory that is on an adapter and 
can be directly modified by the adapter; 
and memory that can be relocated within 
its address space, such as bank-switched 
and expanded-memory-specifications 
(EMS) memory. This memory is not 
cached. 


The following are constraints on memory configurations for 
Personal System/2 systems: 


Memory below 1MB is focal memory. 


All local memory is system memory and can be cached 


except for: 


— The extended BIOS data area 

— The video-buffer areas (hex A000 and hex BO00) 

— The adapter-ROM areas (hex C000 and hex D000) 

— The BIOS code areas (hex E000 and hex F000). 

Local memory from 1MB to 16MB is configured contiguously 


from 1MB. 


System memory on adapters from 1MB to 16MB is configured 
contiguously from 1MB and immediately after any local 
memory in this range. 


Local memory from 16MB to 4GB is configured contiguously 


from 16MB. 


System memory on adapters from 16MB to 4GB is configured 
contiguously from 16MB and immediately after any local 
memory in this range. 
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* Local memory that is reassigned from the first 1MB might be 
configured above channel system memory in either range to 
make full use of the first IMB. This memory is treated as an 
extension of the channel memory in that range. 


| (AH) = C8H—Enable/Disable Processor Functions 


| Note: In an 80486 processor, any external caches must be disabled 
when the on-chip cache (L1) is disabled. 


For Personal System/2 Model 70-A21: 
(AL) = 00H - Disable cache 

= 01H - Enable cache 

= 02H to FFH - Reserved 


On Return: 
CF = 0- Operation successfully completed 
= 1- Operation failed 


| For Personal System/2 Model 70/486 and Model 80-A21: 
(AL) = OOH - Disable cache 
= 01H - Enable cache 

= 02H to FFH - Reserved 


On Return: 
(AH) - Return code 
= 00H - Operation successfully completed 
= 01H - Function choice in (AL) is invalid 
= 02H - NVRAM data is invalid 
= 03H - Cache test error 
CF = 0- Operation successfully completed 
| = 1- Operation failed 


| For Personal System/2 Model 90 and Model 95: 


| (AL) = 00H - Disable cache L1 (cache is flushed when disabled) 
= 01H - Enable cache L1 (cache is flushed when enabled) 

02H - Disable cache L2 (cache is flushed when disabled) 

03H - Enable cache L2 (cache is flushed when enabled) 

04H - Disable both caches 

05H - Enable both caches 


monn 
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On Return: 

(AH) - Return code 
= 00H - Operation successfully completed 
= 01H - Function choice in (AL) is invalid 
= 02H - NVRAM data is invalid 
= 03H - Cache test error 
= 04H - Cannot perform the operation because of the 

state of the other cache 

= O5H - No L2 cache is present 

CF = 0- Operation successfully completed 

= 1- Operation failed 


(AL) = O6H - Return status of both caches 


On Return: 
(BH) - Status of cache L2 
= 0 - Enabled 
= 1- Disabled 
(BL) - Status of cache L1 
= 0- Enabled 
= 1- Disabled 
If the L2 cache is not installed, the L2 cache status is 
always set to 1 (disabled). 
(AH) - Return code 
= OOH - Operation successfully completed 
= 01H - Function choice in (AL) is invalid 
= 02H - NVRAM data is corrupt 
= 03H - Cache test error 
= 04H - Cannot perform the operation because of the 
state of the other cache 
= 05H - No L2 cache is present 
CF = 0- Operation successfully completed 
= 1- Operation failed 


(AL) = 07H to FFH - Reserved 


For ali other Personal System/2 systems, this function is not 
supported: 


On Return: 
(AH) = 86H - Function not supported 
CF = 0- Operation successfully completed 
= 1- Operation failed 


(AH) = C9H—Processor Type and Stepping Level 


To obtain a complete Micro Channel configuration table, the 
Return System Configuration Parameters function ((AH)=COH), 
the Return Memory-Map Information function ((AH)=C7H), and 
the Return Device Descriptor Table (DDT) Information function 
((AH) =D1H) must be called in addition to the Processor Type and 
Stepping Level function ((AH) = C9H). 
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This function is not supported on all systems. If the function is 
not supported, the carry flag is set to 1, and the value that is 
returned in (AH) is either hex 80 (for PC/r and PC) or hex 86. 


On Return: 
(CH) - Microprocessor type 
= 03 - 80386 
= 23 - 80386 SX 
= 04 - 80486 
(CL) - Microprocessor stepping level 
(AH) - Return code 
= 00H - Operation successfully completed 
= 80H or 86H - Function not supported 
CF = 0- Operation successfully completed 
= 1- Operation failed or function not supported 


(AH) = CAH to CDH—Reserved 
(AH) = CEH—Allocate DMA Arbitration Level 


This function is not supported on all systems. If the function is not 
supported, the carry flag is set to 1, and the value that is returned in 
(AH) is either hex 80 (for PCjr and PC) or hex 86. 


DMA channels are either physical or virtual. A physical channel can 
have only one arbitration level assigned to it. A virtual channel! can 
be programmed to use any arbitration level that is not currently 
assigned to a different channel. 


There is no difference in function between physical and virtual 
channels. Priority of the channels is determined by the arbitration 
level; arbitration level 0 has the highest priority, and arbitration level 
hex OE has the lowest priority. 


To perform a DMA transfer operation, the calter performs the 
following steps: 

1. Request that CBIOS DMA allocate an arbitration level. 

2. Set up the hardware and perform the transfer to a device. 


3. Request that CBIOS DMA deallocate the arbitration level. See 
the Deailocate DMA Arbitration Level function ((AH) = CFH) on 
page 2-IN15-39. 


Failure to use this function for the allocation of arbitration levels can 
cause unpredictable results. 
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(BL) = OOH to OEH - Arbitration level to be allocated 
= OFH to FFH - Reserved 


(AL) - Option byte 
Bits 7 to 1 = 0- Reserved 
Bit 0 = 0 - Need DMA channel for arbitration level requested 
= 1-Nochannel required for arbitration level 


On Return: 

(AL) - Channel! number 

= QOH to 07H - Channel number allocated for the 
arbitration level 

08H to FEH - Reserved 
FFH - No channel requested for arbitration level 
- Return code 
OOH - Operation successfully completed 
O1H - Arbitration level not available 
= 02H - Channel not available 
= 03H - invalid arbitration level passed 
80H or 86H - Function not supported 
CF = 0- Operation successfully completed 

= 1- Operation failed or function not supported 


"oa 
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(AH) = CFH—Deallocate DMA Arbitration Level 


This function is not supported on all systems. If the function is not 
supported, the carry flag is set to 1, and the value that is returned in 
(AH) is either hex 80 (for PCjr and PC) or hex 86. 


(BL) = OOH to OEH - Arbitration level to be deallocated 
= OFH to FFH - Reserved 


On Return: 
(AH) - Return code 
= OOH - Operation successfully completed 
= 04H - Arbitration level not allocated 
80H or 86H - Function not supported 
CF = 0 - Operation successfully completed 
= 1- Operation failed or function not supported 


nol 


Failure to use this function for the allocation of arbitration levels can 
cause unpredictable results. 


(AH) = DOH—Reserved 
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| (AH) = D1H—Return Device Descriptor Table (DDT) Information 


This function is not supported on all systems. If the function is 
| not supported, the carry flag is set to 1, and the value that is 
returned in (AH) is either hex 80 (for PCjr and PC) or hex 86. 


To obtain a complete Micro Channel configuration table, the 

| Return System Configuration Parameters function ((AH) =COH), 
the Return Memory-Map Information function ((AH) =C7H), and 
the Processor Type and Stepping Level function ((AH) = C9H) 
must be called in addition to the Return Device Descriptor Table 
Information function ((AH) = D1H). 


(AL) = OOH - Return number of device descriptor table (DDT) 
entries 
(DX) - Reserved (set to 0) 


On Return: 
(BL) - Size of one DDT entry, in bytes 
(CX) - Number of DDT entries 
(AH) - Return code 
00H - Operation successfully completed 
01H - Requested DDT entry not found 
02H - DDT data not valid 
86H - Function not supported 
| CF = Q- Operation successfully completed 
= 1- Operation failed or function not supported 


(AL) = 01H - Return DDT entry on the basis of the entry number 
(BX) - Number of requested entry (one-based) 
(DX) - Reserved (set to 0) 
(ES:Dl) - Pointer to buffer that contains DDT entry 


On Return: 
(ES:DI) - Pointer to buffer that contains DDT entry 
(AH) - Return code 
= OOH - Operation successfully completed 
= 01H - Requested DDT entry not found 
= 02H - DDT data not valid 
= 86H - Function not supported 
CF = 0- Operation successfully completed 
= 1- Operation faiied or function not supported 
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(AL) = 02H - Return DDT entry on the basis of the I/O port address 


(The DDT is searched from the specified entry 
for the i/O port in (CX), and the first entry that is 
found is returned.) 

(BX) - Entry number from which to start search 

(CX) - Requested !/O port address 

(DX) - Reserved (set to 0) 

(ES:Dl) - Pointer to buffer that contains DDT entry 


On Return: 
(BX) - DOT entry number where requested I/O port address 
was found 
(If the requested I/O port address is not found, 
this value is the total number of DDT entries 
plus 1.) 
(ES:D)) - Pointer to buffer that contains DDT entry 
(AH) - Return code 
= OOH - Operation successfully completed 
= 01H - Requested DDT entry not found 
= 02H - DDT data not valid 
86H - Function not supported 
CF = 0 - Operation successfully completed 
= 1- Operation failed or function not supported 


(AL) = O3H - Return entire DDT 
(DX) - Reserved (set to 0) 
(ES:DI) - Pointer to buffer that contains DDT entry 


On Return: 
(ES:Dl) - Pointer to buffer that contains DDT entry 
(AH) - Return code 
= OOH - Operation successfully completed 
= OTH - Requested ODT entry not found 
= 02H - DDT data not valid 
= 86H - Function not supported 
CF = 0- Operation successfully completed 
= 1 - Operation failed or function not supported 


(AL) = 04H - Return DDT entry on the basis of the device ID 

(The DDT is searched from the specified entry 
for the device ID in (CX), and the first entry 
that is found is returned.) 

(BX) - Entry number from which to start search 

(CX) - Requested device ID 

(DX) - Reserved (set to 0) 

(ES:Dl) - Pointer to buffer that contains DDT entry 
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On Return: 

(BX) - Entry number where requested device ID was found 
(If the requested device ID is not found, this 
value is the total number of DDT entries plus 1.) 

(ES:DI) ~ Pointer to buffer that contains DDT entry 

{AH) - Return code 

= QOH - Operation successfully compieted 
01H - Requested DDT entry not found 
02H - DDT data not valid 
86H - Function not supported 
CF = Q- Operation successfully completed 
= 1- Operation failed or function not supported 


yuna 


The device descriptor table (DDT) contains information about 
resources that are used by each device. An adapter is 
considered to be a single device unless it is divided into multiple 
devices by the BEGIN and END keywords in the adapter 
descriptor files (refer to the Personal System/2 Hardware 
Technical Reference for a description of adapter descriptor files). 
The first byte of the data block that contains the DDT indicates the 
size of each DDT entry. The format of the DDT entry is shown in 
the following table. 


Definition 


Reserved (set to 0) 
Slot of device (0 = system board) 
Second interrupt for this device 


(0 = no second interrupt) 

First interrupt for this device 

(0 = no first interrupt) 

Second arbitration level for this device 
First arbitration level for this device 


Figure 2-25 (Part 1 of 2). Device Descriptor Table (DDT) Entry Format 
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13 


12 


11 


10 


7to0 


[) § Byte 
6 Word 
8 Word 
10 Word 
12 Word 
14 DWord 
18 Word 
20 DWord 
24 Word 


ascending order. 
26 Byte 


| Figure 2-25 (Part 2 of 2). Device Descriptor Table (DDT) Entry Format 


(AH) = D2H to D3H—Reserved 
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Definition 


DOT indicators 
Reserved (set to 0) 
Second arbitration-level indicator 
= 0- No second arbitration level 
= 1- Second arbitration level exists 
First arbitration-level indicator 
= 0- No first arbitration level 
= 1- First arbitration level exists 
Serial-interface type 
= 0- Not RS-422 
= 1-RS-422 
Not address limited 
= 0- Address limited 
= 1- Not address limited 
DMA channel required 
= 0- DMA channel not used 
= 1- DMAchannel used 
Second arbitration level can be shared 
= 0- Not shared 
= 1- Shared 
First arbitration level can be shared 
= 0- Not shared 
= 1- Shared 
Reserved (set to 0) 
Reserved (set to 0) 
Device ID 
= 0- No device ID 
Starting address of first 1/O block 
= 0-No first I/O block 
Starting address of second I/O block 
= 0- No second I/O block 
Starting address of third [I/O block 
= 0-No third I/O block 
Start of first non-system memory block 


= 0- No first non-system memory block 


Size of first non-system memory block 
(number of 1KB blocks) 


Start of second non-system memory block 
= 0-No first non-system memory block 
Size of second non-system memory block 


(number of 1KB blocks) 


Note: |/O block addresses and non-system memory addresses are listed in 


implementation identifier of the device 


Implementation revision level of the device 


2-1N15-43 


(AH) = D4H—Return Physical Fixed Disk Drive Number (Selectable 
Boot) 


This function is not supported on all systems. If the function is 
not supported, the carry flag is set to 1, and the value that is 
returned in (AH) is either hex 80 (for PC/r and PC) or hex 86. 


(DL) - Logical fixed disk drive number 


On Return: 

(AL) - Physical fixed disk drive number 

(AH) - Return code 
= OOH - Operation successfully completed 
= O1H - Specified logical drive number is invalid 
= 86H - Function not supported 

CF = 0 - Operation successfully completed 

= 1- Operation failed 


(AH) = D5H—Reserved 


| (AH) = D6H—Return Boot Device ID and Key 


| (AL) = 00H - Read/write boot device ID 
| (BL) = 0- Read 

| = 1- Write 

| (DX) - Device ID to be written/read 

| On Return: 


| (AH) = 00H - Operation successfully completed 
= 86H - Function not supported 


CF=0 
(AL) = 01H - Read/write boot device key 
| (BL) = 0- Read 
| = 1- Write 


(DX) - Device ID to be written/read 


On Return: 

| (AH) = 00H - Operation successfully completed 
= 86H - Function not supported 

| CF =0 


(AL) = 02H - Query boot reference partition 


| On Return: 

(AL) - Status of reference-partition boot request 
= OOH - Reference-partition boot not requested 
= 01H - Reference-partition boot requested 

| (AH) = QOH - Operation successfully completed 

= 86H - Function not supported 

| CF =0 


(AH) = D7H to FFH—Reserved 
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Interrupt 16H—Keyboard 


These routines provide keyboard support. The following is a 
summary of the keyboard functions of Interrupt 16H. 


(AH) = 00H — Keyboard Read 
(AH) = 01H — Keystroke Status 
(AH) = 02H — Shift Status 
(AH) = 03H — Set Typematic Rate 
(AH) = 04H — Keyboard Click Adjustment 
(AH) = 05H — Keyboard Write 
(AH) = 06H to 08H — Reserved 
(AH) = 09H — Keyboard Functionality Determination 
|| (AH) = OAH ~ Return Keyboard ID 
(AH) = OBH to OFH — Reserved 
(AH) = 10H — Extended-Keyboard Read 
(AH) = 11H — Extended Keystroke Status 
(AH) = 12H — Extended Shift Status 
(AH) = 13H to 1FH — Reserved 
(AH) = 20H — Keyboard Read for the 122-Key Keyboard 
(AH) = 21H — Keystroke Status for the 122-Key Keyboard 
(AH) = 22H — Shift Status for the 122-Key Keyboard 
(AH) = 23H to FFH — Reserved 


Figure 2-26. INT 16H Keyboard Functions 
Note: All reserved input fields must be set to 0. 


| Functions (AH)= 10H, 11H, and 12H support the 101-/102-key 

| keyboard. Functions (AH) = 20H, 21H, and 22H support the 122-key 

| keyboard. The keyboard scan codes for these functions fall into three 
| categories: 


5) 
= 
@ 
ae 
my 
Cc 
ae) 
= 
—" 
D 
T 
rx 
® 
< 
oy 
fe) 
2 
oO: 


e When only one key produces an ASCII character, the scan code 
that is read from the keyboard port is the same as that with 
standard keyboards. 


e When more than one key produces the same character, one of the 
keys generates the standard keyboard scan code. The other key 
generates a unique sequence of scan codes, enabling the system 
to differentiate between the keys. 


* New scan codes are assigned to keys that do not exist on the 
standard keyboards. 


| The 101-/102-key keyboard functions and the 122-key keyboard 
| functions enable new programs to take advantage of ail categories 
| and avoid compatibility problems with existing programs. 
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| If the system BIOS does not support the 101-/102-key keyboard 

| functions and the 122-key keyboard functions, the scan 

| code/character code combination that was put into the keyboard 

| buffer by the keyboard interrupt handler is returned unchanged when 
| the Keyboard Read function ((AH) = 00H) and the Keystroke Status 

| function ((AH) =01H) are calied. 


| If the system BIOS supports the 101-/102-key keyboard functions and 
| the 122-key keyboard functions: 


¢ Keys with identical names are differentiated by the character 
code that is put into the keyboard buffer by the keyboard interrupt 
handler. 


¢ The keyboard interrupt handler puts the scan code/character 
code combination for new keys into the keyboard buffer. 


¢ The Extended-Keyboard Read function ((AH) = 10H), the Extended 
Keystroke Status function ((AH) = 11H), the Keyboard Read 
function for the 122-Key Keyboard function ((AH) = 20H), and the 
Keystroke Status for the 122-Key Keyboard function ((AH) = 21H), 
extract the scan code/character code combination from the buffer 
as is and return it to the caller. The scan code/character code 
combination is returned for new keys. it is also returned for keys 
with identical names, and the character code is used to 
differentiate between them. If the character code is hex FO and 
the scan code is not hex 00, the character code is set to hex 00. 


¢ The Keyboard Read function ((AH) =00H) and the Keystroke 
Status function ((AH) =01H) extract the scan code/character code 
combination and translate it, if necessary, to the scan 
code/character code combination that is compatible with previous 
keyboards. The translation: 


1. Converts like codes to compatible codes 


2. Extracts scan code/character code combinations until a 
compatible combination is found. 


| © The Extended Shift Status function ((AH) = 12H) and the Shift 

| Status for the 122-Key Keyboard function ((AH) = 22H) return the 

| existing keyboard shift state and the shift state of the separate 
Ctrl and Alt keys. 


If the Keyboard Functionality Determination function ((AH) = 09H) is 
supported, use it to determine whether the system BIOS supports the 
| functions for the 101-/102-key keyboard ((AH)=10H, 11H, and 12H) 
| and the 122-key keyboard ((AH) =20H, 21H, and 22H). 


2-IN16-2. Keyboard—September 1991 


If the Keyboard Functionality Determination function ((AH) =09H) is 
not supported, the program must use the following procedure: 


1. Use Interrupt 16H, Keyboard Write function ((AH) =05H) to write a 
scan code/character code combination of hex FFFF to the buffer. 


2. If (AL) is set to OOH on return, the function has successfully 
written hex FFFF to the buffer. 


3. Use Interrupt 16H, Extended-Keyboard Read function ((AH) = 10H) 
or Keyboard Read for the 122-Key Keyboard function ((AH) = 20H) 
to read the scan code/character code combination from the 
keyboard buffer. 


4. If (AX) is set to hex FFFF on return, the functions for the 
101-/102-key keyboard and the functions for the 122-key keyboard 
are supported. 


5. If (AX) is not set to hex FFFF on return, call Interrupt 16H, 
(AH) = 10H or (AH) =20H repeatedly until (AX) is set to hex FFFF 
on return. 


6. If (AX) is still not set to hex FFFF after 16 calls to (AH) = 10H or 
(AH) = 20H, the functions for the 101-/102-key keyboard and the 
functions for the 122-key keyboard are not supported. 


See the “Scan Code/Character Code Combinations” section. 
(AH) = 00H—Keyboard Read 


The scan code/character code combination is extracted from the 
buffer. The keyboard-buffer head pointer (address hex 40:1A) is 
increased by 2 or, if the pointer is already at the end, it is reinitialized 
to the start of the buffer. 


On Return: 
(AH) - Scan code 
(AL) - ASCII character code 


For AT, PC/XT Model 286, PC Convertible, and Personal System/2 
products, if no keystroke is available, Interrupt 15H, Device Busy 
function ((AH) = 90H) is called with (AL) =02H (Type = Keyboard) to 
inform the operating system that a keyboard loop is about to take 
place, enabling the operating system to perform another task. When 
the keyboard operation is complete, Interrupt 09H calls Interrupt 15H, 
Interrupt Complete function ((AH) =91H), with (AL) =02H 

(Type= Keyboard). See “Multitasking Provisions” in the “Additional 
Information” section. 
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Note: Conirol is returned only when a keystroke is available. The 
keystroke is removed from the buffer. 


(AH) = 01H—Keystroke Status 


On Return: 
CF = 0- Code is available 
= 1- No code is available 


If a code is available: 
(AH) - Scan code 
(AL) - ASCII character code 


Note: The keystroke is not removed from the buffer. 


(AH) = 02H—Shift Status 


On Return: 

(AH) - Reserved 

(AL) - Current shift status 
Bit 7 = 1- Insert locked 
Bit 6 = 1- Caps Lock locked 
Bit 5 = 1- Num Lock locked 
Bit 4 = 1 - Scroil Lock locked 
Bit 3 = 1 - Alt key pressed 
Bit 2 = 1- Ctri key pressed 
Bit 1 = 1 - Left Shift key pressed 
Bit 0 = 1 - Right Shift key pressed 


(AH) = 03H—Set Typematic Rate 


For PCjr and Personal System/2 BIOS that supports Interrupt 16H, 
Keyboard Functionality Determination function ((AH) =09H) with 
bit 0 set to 1: 


(AL) = OOH - Returns to default; restores original state 
(typematic on, normal initial delay and normal 
typematic rate) 


For PCjr only: 


(AL) = 01H - Increases the initial delay (this is the delay between 
the first character and the burst of typematic 
characters) 

(AL) = 02H - Slows typematic characters by one-half 

(AL) = O3H - Increases the initia! delay and slows typematic 
characters by one-half 
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For PCjr and Personal System/2 BIOS that supports Interrupt 16H, 
Keyboard Functionality Determination function ((AH) =09H) with 
bit 1 set to 1: 


(AL) = 04H - Turns off typematic characters 


For AT BIOS dated 11/15/85 and later, PC/XT Model 286, and 
Personal System/2 products: 


(AL) = 05H - Set typematic rate and delay 
(BH) - Delay value (in milliseconds) 


00H = 250 
01H = 500 
02H = 750 
03H = 1000 


04H to FFH - Reserved 
(BL) - Typematic rate (in characters per second) 

00H = 30.0 OBH = 10.9 16H = 4.3 
O1H = 26.7 OCH = 10.0 17H = 4.0 
02H = 24.0 ODH = 9.2 18H = 3.7 
03H = 21.8 OEH = 86 19H = 3.3 
04H = 20.0 OFH = 80 1AH = 3.0 
05H = 18.5 10H = 7.5 1BH = 27 
06H = 17.1 11H = 67 1CH = 2.5 
07H = 16.0 12H = 6.0 1DH = 2.3 
08H = 15.0 13H = 5.5 1EH = 2.1 
09H = 13.3 14H = 5.0 1FH = 2.0 
OAH = 12.0 15H = 46 20H to FFH - Reserved 


For Personal System/2 BIOS that supports Interrupt 16H, 
Keyboard Functionality Determination function ((AH) =09H) with 
bit 3 set to 1: 


(AL) = O6H - Return current typematic rate and delay 


On Return: 
(BH) - Delay value 
(BL) - Typematic rate 


For all others, no action is performed. 


(AH) = 04H—Keyboard Click Adjustment 
For PCjr and PC Convertible: 


(AL) = OOH - Set keyboard click off 
(AL) = 01H - Set keyboard click on 


For all others, no action is performed. 
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(AH) = 05H—Keyboard Write 


For AT BIOS dated 11/15/85 and later, PC/XT dated 1/10/86 and 
later, PC/XT Model 286, and Personal System/2 products, this 
function puts scan code/character code combinations into the 
keyboard buffer as if they came from the keyboard. 


(CH) - Scan code 
(CL) - ASCII character code 


On Return: 


(AL) = 00H - Operation successfully completed 


= 01H - Buffer fult 


For all others, no action is performed. 


(AH) = 06H to 08H—Reserved 


(AH) = 09H—Keyboard Functionality Determination 


To determine whether Interrupt 16H, Keyboard Functionality 
Determination function ((AH) = 09H) is supported, the program must 
use Interrupt 15H, Return System Configuration Parameters function 
((AH) = COH), testing bit 6 of feature information byte 2. If this bit is 
set to 0, the function is not supported. If this bit is set to 1, the 
function is as follows. This test can be performed for all systems that 
support Interrupt 15H, Return System Configuration Parameters 
function ((AH) = COH). 


On Return: 


(AL) - 


Function code 


Bit 7 - Reserved 


Bit 
Bit 
Bit 


Bit 


Bit 
Bit 


Bit 
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6 = 1- 122-key keyboard functions are supported 
= 0- 122-key keyboard functions are not supported 
5 = 1- 101-/102-key keyboard functions are supported 
= 0 - 101-/102-key keyboard functions are not supported 
4 = 1- Keyboard ID is supported 
= 0- Keyboard ID is not supported 
3 = 1- Get current typematic rate/delay is supported 
= 0 - Get current typematic rate/delay is not 
supported 
2 = 1 - Set typematic rate/delay is supported 
= 0- Set typematic rate/delay is not supported 
1 = 1- Turn on/off typematic is supported 
= 0- Turn on/off typematic is not supported 
0 = 1- Return to default typematic rate/delay 
is supported 
= Q- Return to default typematic rate/delay 
is not supported 


Keyboard—September 1991 


(AH) = OAH—Return Keyboard ID 
Use this function to determine the type of keyboard that is attached. 


To determine whether this function is supported, use Interrupt 16H, 
Keyboard Functionality Determination function ((AH) = 09H), testing 
| bit 4 of the AL register. If this bit is set to 0, the function is not 
supported. If this bit is set to 1, the function is as follows: 


On Return: 
(BX) = Keyboard ID 
= 0000 - No keyboard attached 
= 0001 to FFFFH - Keyboard attached, reserved for keyboard IDs 
| (BH) - Second byte of keyboard ID 
| (BL) - First byte of keyboard ID 


| The valid keyboard IDs are: 


| (BX) = 41AB - G-layout, 101- and 102-key (translated) 
| 83AB - G-layout, 101- and 102-key 

H 54AB - P-layout (translated) 

| = 84AB - P-layout 
| 

| 

| 


= 86AB - 122-key 
= 90AB - DBCS G-layout (5576-002) 
= 91AB - DBCS P-layout (5576-003) 
= 92AB - DBCS A-layout (5576-001) 


(AH) = OBH to OFH--Reserved 


(AH) = 10H—Extended-Keyboard Read 


For AT BIOS dated 11/15/85 and later, PC/XT dated 1/10/86 and 
later, PC/XT Model 286, and Personal System/2 products, the 
scan code/character code combination is extracted from the 
buffer. The keyboard-buffer head pointer (address hex 40:1A) is 
increased by 2 or, if the pointer is already at the end, itis 
reinitialized to the start of the buffer. 


On Return: 


(AH) - Scan code 
(AL) - ASCII character code 


Note: Control is returned only when a keystroke is available. 
The keystroke is removed from the buffer. 


For all others, no action is performed. 
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(AH) = 11H—Extended Keystroke Status 


For AT BIOS dated 11/15/85 and later, PC/XT dated 1/10/86 and 
later, PC/XT Model 286, and Personal System/2 products: 


On Return: 
CF = 0 - Code is available 
= 1-No code is availabie 


lf a code is available: 
(AL) - ASCII character code 
(AH) - Scan code 


Note: The keystroke is not removed from the buffer. 
For all others, no action is performed. 


(AH) = 12H—Extended Shift Status 


For AT BIOS dated 11/15/85 and later, PC/XT dated 1/10/86 and 
later, PC/XT Model 286, and Personal System/2 products: 


On Return: 

(AH) - Extended shift status 
Bit 7 = 1- SysRq key pressed 
Bit 6 = 1 - Caps Lock key pressed 
Bit 5 = 1- Num Lock key pressed 
Bit 4 = 1- Scroll Lock key pressed 
Bit 3 = 1- Right Alt key pressed 
Bit 2 = 1 - Right Ctrl key pressed 
Bit 1 = 1 - Left Alt key pressed 
Bit 0 = 1 - Left Ctrl key pressed 

(AL) - Shift status 
Bit7 = 1- Insert locked 
Bit 6 = 1 - Caps Lock locked 
Bit 5 = 1- Num Lock locked 
Bit 4 = 1 - Scroll Lock locked 
Bit 3 = 1- Alt key pressed 
Bit 2 = 1- Ctrl key pressed 
Bit 1 = 1- Left Shift key pressed 
Bit 0 = 1 - Right Shift key pressed 


For all others, no action is performed. 


(AH) = 13H to 1-FH—Reserved 
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(AH) = 20H—Keyboard Read for the 122-Key Keyboard 


For Personal System/2 Model 35 SX, Model 35 LS, Model 40 SX, and 
Model 57 SX, the scan code/character code combination is extracted 
from the buffer. The keyboard-buffer head pointer (address hex 
40:1A) is increased by 2 or, if the pointer is already at the end, it is 
reinitialized to the start of the buffer. 


On Return: 
(AH) - Scan code 
(AL) - ASCII character code 


Note: Control is returned only when a keystroke is available. The 
keystroke is removed from the buffer. 
(AH) = 21H—Keystroke Status for the 122-Key Keyboard 


For Personal System/2 Model 35 SX, Model 35 LS, Model 40 SX, 
and Model 57 SX: 


On Return: 
CF = 0- Code is available 
= 1-No code is available 


lf a code is available: 
(AL) - ASCII character code 
(AH) - Scan code 


Note: The keystroke is not removed from the buffer. 
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| (AH) = 22H—Shift Status for the 122-Key Keyboard 


| For Personal System/2 Model 35 SX, Model 35 LS, Model 40 SX, 
| and Model 57 SX: 


On Return: 
(Ah) - Extended shift status 
| Bit 7 = 1- SysRq key pressed 
Bit 6 = 1- Caps Lock key pressed 
Bit 5 = 1- Num Lock key pressed 
Bit 4 = 1- Scroll Lock key pressed 
| Bit 3 = 1- Right Alt key pressed 
Bit 2 = 1 - Right Ctrl key pressed 
Bit 1 = 1 - Left Alt key pressed 
BitO = 1 - Left Ctrl key pressed 
(AL) - Shift status 
Bit 7 = 1- Insert locked 
Bit 6 = 1- Caps Lock locked 
| Bit 5 = 1- Num Lock locked 
Bit 4 = 1- Scrofl Lock locked 
Bit 3 = 1- Alt key pressed 
| Bit 2 = 1- Ctrl key pressed 
Bit 1 = 1- Left Shift key pressed 
Bit 0 = 1- Right Shift key pressed 


(AH) = 23H to FFH—Reserved 
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Interrupt 17H—Printer 


These routines provide printer support. The following is a summary 
of the printer-support functions of Interrupt 17H. 


(AH) = 00H — Print Character 
(AH) = 01H — Initialize the Printer Port 


(AH) = 02H — Read Status 
(AH) = 03H to FFH ~ Reserved 


Figure 2-27. INT 17H Printer Functions 
Note: All reserved input fields must be set to 0. 


(AH) = 00H—Print Character 


(AL) - Character to be printed 
(DX) - Printer to be used (0, 1, or 2); index into the port base 
address table at address hex 40:08 


On Return: 
(AH) - Status 

Bit 7 = 1 - Not busy 

Bit 6 = 1 - Acknowledgment 
Bit 5 = 1 - Out of paper 
Bit 4 = 1 - Selected 

Bit3 = 1-1/0 error 

Bits 2, 1 - Reserved 

Bit 0 = 1 - Time-out 
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(AH) = 01H—Initialize the Printer Port 


(DX) - Printer to be used (0, 1, or 2); index into the port base 
address table at address hex 40:08 


On Return: 
(Ah) - Status (see status values on page 2-IN17-1) 


(AH) = 02H—Read Status 


(DX) - Printer to be used (0, 1, or 2); index into the port base 
address table at address hex 40:08 


On Return: 
(AR) - Status (see status values on page 2-IN17-1) 


(AH) = 03H to FFH—Reserved 
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Notes: 


1. 


For AT, PC/XT Model 286, PC Convertible, and Personal System/2 
products, when the printer is busy, BIOS calls Interrupt 15H, 
Device Busy function ((AH) =90H) with (AL) =FEH (Type = Printer) 
to inform the operating system that a time-out loop is about to 
begin. See “Multitasking Provisions” in the “Additional 
Information” section. 


. For AT BIOS dated before 11/15/85, PCjr, PC, and PC/XT BIOS 


dated 11/8/82, the printer-port number that is associated with (DX) 
is tested for 0. If (DX) is set to 0, no action occurs. If (DX) is not 
set to 0, the print operation is performed. The (DX) register is not 
tested for a valid printer-port number at the offset into the printer 
base address data area at address hex 40:08. 


. For PC/XT BIOS dated 1/10/86 and later, if the value of (DX) is 


greater than 3 or the printer port that is associated with (DX) is 
printer port 0, no action is performed, and on return, (AH) is set to 
29H. 


. For PC Convertible, if the printer port that is associated with (DX) 


is printer port 0, (AH) is set to 01H on return. If (DX) is not set to 
0, the print operation is performed. The (DX) register is not 
tested to determine whether a valid printer-port number exists at 
the offset into the printer base address data area at address hex 
40:08. 


. For AT BIOS dated 11/15/85 and PC/XT Model 286, if the value of 


(DX) is greater than 3 or the printer port that is associated with 
(DX) is printer port 0, no action is performed, and (AH) is returned 
unchanged. 


. For Personal System/2 products, if the value of (DX) is greater 


than 2 or the printer port that is associated with (DX) is printer 
port 0, no action is performed, and (AH) is returned unchanged. 
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Interrupt 19H—Bootstrap Loader 


| Devices that are supported by Interrupt 13H read the boot record from 
| cylinder 0, head 0, sector 1. Devices that are supported by Interrupt 

| 4BH read the boot record from logical block address 1. The boot 

| record is then read into system memory at address hex 0000:7C00. 


| The power-on self-test (POST) checks for the following characteristics 
| to validate a boot record: 


| © For a device with removable media, such as a diskette, the boot 
| record must contain valid code. For example, the value of the 
| first byte of the boot record must be greater than 6. 
| 
| 
| 


¢ For a device with nonremovable media, such as a fixed disk, 
there must be a signature of hex 55AA at the end of the boot 
record. 


| Parameters that identify the device from which the boot record was 
| obtained are passed to the boot record. Passing of these parameters 
| enables the boot record to continue the system boot operation. 


| In systems that do not support Interrupt 15H, Return Boot Device and 
| Key function ((AH)= D6H), the following information is passed to the 
| boot record: 


H (CS) = 0000H 
| (IP) = 7COOH 
| (DL) - Drive from which the boot record was read 
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| In systems that support Interrupt 15H, Return Boot Device and Key 

| function ((AH) = D6H), information is passed also to the DX register. If 
| the access-mode bit (bit 5) is set to 0, the DX register is defined as the 
| “boot device identifier”; if the access-mode bit is set to 1, the DX 

| register is defined as the “device key.” The device key is a 16-bit 

| value that is returned by Interrupt 4BH, Allocate Device function 

| ((AH) =80H, (AL)=02H), (AX) = 8002H. (The device key is available 

| also from Interrupt 15H, Return Boot Device ID and Key function 

| ((AH) = D6H).) 
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The following information is passed to the boot record: 


(CS) = 0000H 
(IP) = 7COOH 
(DX) - Boot device identifier or device key 


When (DX) is a boot device identifier, (DH) and (DL) are 
defined as follows: 


(DH) - Device identifier 
Bit 7 - Removable-media indicator 
= 0- Nonremovable media 
= 1- Removable media 
Bit 6 - Reserved 
Bit 5 - Access mode 
= 0- Device is supported by Interrupt 13H 
= 1- Device is supported by Interrupt 4BH 
Bits 4 to 0 - Peripheral-device type 
(DL) - Device instance 
= 00H - First diskette drive (if the access-mode bit 
is set to 0) 
- First CD-ROM drive (if the access-mode bit 
is set to 1) 
= 80H - First fixed disk drive (if the access-mode bit 
is set to 0) 
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Interrupt 1AH—System-Timer and Real-Time 
Clock Services 


The following is a summary of the system-timer and real-time clock 
services of Interrupt 1AH. 


(AH) = 00H — Read System-Timer Time Counter 
(AH) = 01H — Set System-Timer Time Counter 
(AH) = 02H ~ Read Real-Time Clock Time 

(AH) = 03H — Set Real-Time Clock Time 


(AH) = 04H — Read Real-Time Clock Date 

(AH) = 05H — Set Real-Time Clock Date 

(AH) = 06H — Set Real-Time Clock Alarm 

(AH) = 07H ~— Reset Real-Time Clock Alarm 

(AH) = 08H — Set Real-Time Clock Activated Power-On Mode 
(AH) = 09H — Read Real-Time Clock Alarm Time and Status 
(AH) = OAH — Read System-Timer Day Counter 

(AH) = OBH — Set System-Timer Day Counter 

(AH) = OCH to 7FH — Reserved 

(AH) = 80H — Set Up Sound Multiplexer 

(AH) = 81H to FFH — Reserved 


Figure 2-28. INT 1AH System-Timer and Real-Time Clock Services 
Functions 


Notes: 
1. All reserved input fields must be set to 0. 


| 2. Some models of Personal System/2 Model 25 do not support a 
| real-time clock; therefore, functions (AH) =02H through 
(AH) =09H do not apply to those systems. The system-timer 
functions do apply. 


(AH) = 00H—Read System-Timer Time Counter 


On Return: 

(AL) = 0 - Timer has not passed 24 hours’ worth of counts since 
power-on, last system reset, last system-timer time 
counter read, or last system-timer time counter set 

> 0- Timer has passed 24 hours’ worth of counts since 
power-on, last system reset, last system-timer time 
counter read, or last system-timer time counter set 

(CX) - High portion of count 

(DX) - Low portion of count 
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Note: Execution causes the timer overflow flag (hex 40:70) to be 
reset to 0. Counts occur at the rate of approximately 18.2 per 
second. 
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(AH) = 01H—Set System-Timer Time Counter 


(CX) - High portion of count 
(DX) - Low portion of count 


Note: Execution causes the timer overflow flag (hex 40:70) to be 
reset to 0. Counts occur at the rate of approximately 18.2 
counts per second. 


(AH) = 02H—Read Real-Time Clock Time 
For AT BIOS dated before 6/10/85: 


On Return: 
(CH) - Hours, in binary-coded decimal notation (BCD) 
(CL) - Minutes, in BCD 
(DH) - Seconds, in BCD 
CF = 0- Clock operating 
= 1- Clock not operating 


For AT BIOS dated 6/10/85 and later, PC/XT Model 286, PC 
Convertible, and Personal System/2 products: 


On Return: 
(CH) - Hours, in BCD 
(CL) - Minutes, in BCD 
(DH) - Seconds, in BCD 
(DL) = 01H - Daylight saving time option 
= 00H - No daylight saving time option 
CF = 0- Clock operating 
= 1- Clock not operating 


For all others, no action is performed. 


(AH) = 03H—Set Real-Time Clock Time 


For AT, PC/XT Model 286, PC Convertible, and Personal System/2 
products: 


(CH) - Hours, in BCD 

(CL) - Minutes, in BCD 

(DH) - Seconds, in BCD 

(DL) = O1H - Daylight saving time option 
= 00H - No daylight saving time option 


Note: For Personal System/2 Model 30, (DL) is not used. 


For all others, no action is performed. 
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(AH) = 04H—Read Real-Time Clock Date 


For AT, PC/XT Model 286, PC Convertible, and Personal System/2 
products: 


On Return: 
(CH) - Century (19 or 20), in BCD 
(CL) - Year, in BCD 
(DH) - Month, in BCD 
(DL) - Day, in BCD 
CF = 0 - Clock operating 
= 1- Clock not operating 


For all others, no action is pertormed. 


(AH) = 05H—Set Real-Time Clock Date 


For AT, PC/XT Model 286, PC Convertible, and Personal System/2 
products: 


(CH) - Century (19 or 20), in BCD 
(CL) - Year, in BCD 

(DH) - Month, in BCD 

(DL) - Day, in BCD 


For all others, no action is performed. 


(AH) = 06H—Set Real-Time Clock Alarm 


For AT, PC/XT Model 286, PC Convertible, and Personal System/2 
products: 


(CH) - Hours, in BCD 
(CL) - Minutes, in BCD 
(DH) - Seconds, in BCD 


On Return: 
CF = 0- Operation successfully completed 
= 1- Alarm already set or clock not operating 


Note: The alarm interrupt occurs at the specified hour, minute, 
and second that are passed in (CH), (CL), and (DH), 
respectively. When the alarm interrupt occurs, software 
Interrupt 4AH is issued. The user must point software 
Interrupt 4AH to an alarm routine before setting the 
real-time clock alarm through Interrupt 1AH, Set 
Real-Time Clock Alarm function (AH)=06H). Only one 
alarm function can be active at any time. The alarm 
interrupt occurs every 24 hours at the specified time until 
it is reset. 
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For all others, no action is performed. 


(AH) = 07H—Reset Real-Time Clock Alarm 


For AT, PC/XT Model 286, PC Convertible, and Personal System/2 
products, this function stops the real-time clock alarm interrupt 
from occurring. 


For all others, no action is performed. 


(AH) = 08H—Set Real-Time Clock Activated Power-On Mode 
For PC Convertible: 


(CH) - Hours, in BCD 
(CL) - Minutes, in BCD 
(DH) - Seconds, in BCD 


On Return: 
CF = 0- Operation successfully completed 
= 1- Alarm already set or clock not operating 


For AT BIOS dated 6/10/85 and later, PC/XT Model 286, and 
Personal System/2 products, this function is not supported: 


On Return: 
CF = 1- Invalid function request 


For all others, no action is performed. 


(AH) = 09H—Read Real-Time Ciock Alarm Time and Status 
For PC Convertible and Personal System/2 Model 30: 


On Return: 
(CH) - Hours, in BCD 
(CL) - Minutes, in BCD 
(DH) - Seconds, in BCD 
(DL) - Alarm status 
00H - Alarm not enabled 
01H - Alarm enabled but will not power-on the system 
02H - Alarm enabled and will power-on the system 


out 


Note: Personal System/2 Model 30 does not support the 
power-on system feature. 
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For AT BIOS dated 6/10/85 and iater, PC/XT Model 286, and 
Personal System/2 products except Model 30, this function is not 
supported: 


On Return: 


CF = 1- Invalid function request 


For all others, no action is performed. 
(AH) = OAH—Read System-Timer Day Counter 
For AT and PC/XT Model 286, this function is not supported: 
On Return: 


CF = 1 - Invalid function request 


For PC/XT BIOS dated 1/10/86 and later and Personal System/2 
products: 


On Return: 


(CX) - Count of days since 1 January 1980 (1-1-80) 


Note: The count of days since 1 January 1980 is initialized to 0 
during POST. 


For all others, no action is performed. 


(AH) = OBH—Set System-Timer Day Counter 
For AT and PC/XT Model! 286, this function is not supported: 


On Return: 
CF = 1- Invalid function request 


For PC/XT BIOS dated 1/10/86 and later and Personal System/2 
products: 


(CX) - Count of days since 1 January 1980 (1-1-80) 


Note: The count of days since 1 January 1980 is initialized to 0 
during POST. 


For all others, no action is performed. 


(AH) = 0CH to 7FH—Reserved 
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(AH) = 80H—Set Up Sound Multiplexer 
For PCjr: 


(AL) - Source of sound (“Audio Out” or RF modulator) 
= OOH - 8253 channel 2 
= 01H - Cassette input 
= 02H - “Audio In” tine on I/O channel 
= 03H - Complex sound generator chip 


For AT BIOS dated 6/10/85 and later, PC/XT Model 286, PC 
Convertible, and Personal System/2 products, this function is not 
supported: 


On Return: 
CF = 1 - Invalid function request 


For all others, no action is performed. 


(AH) = 81H to FFH—Reserved 
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Interrupt 4BH—Advanced Services 


The following is a summary of the services available through 
Interrupt 4BH. 


(AH) = 00H to 7FH — Reserved 
{AH) = 80H — SCS! Devices (page 2-IN4B-2) 


(AH) = 81H — Operating-System DMA Services (page 2-IN4B-15) 
(AH) = 82H to FFH — Reserved 


Figure 2-29. INT 4BH Advanced Services 
Note: All reserved input fields must be set to 0. 


The BIOS services that are available through Interrupt 4BH provide 
an interface to certain functions. Before making calls to these 
routines, test the appropriate bits at address hex 40:7B to determine 
whether the routines are supported. 


Services in the SCSI Devices function ((AH) = 80H) provide a generic 
interface to small computer system interface (SCSI) devices. 


Services in the Operating-System DMA Services function ((AH) =81H) 
provide bus masters and operating systems with an interface for 
controlling memory addresses. 


a 
+ 
oO 
bn 
= 
c 
xe} 
-~+ 
aS 
w 
t 
> 
a 
< 
ey) 
> 
(?) 
@ 
a. 
n 
oO 
<. 
i?) 
oO 
n 


Advanced Services—September 1991 2-IN4B-1 


(AH) = 80H—SCSI Devices 


These BIOS services are intended for use by device drivers. 
Application programs should use operating-system interfaces to 
access small computer system interface (SCSI) devices. 


The following is a summary of the SCSI functions. 


(AH) = 00H — Get Device Count (page 2-IN4B-3) 
(AH) = 01H — Get Device Data (page 2-IN4B-4) 
(AH) = 02H — Allocate Device (page 2-IN4B-4) 
(AH) = 03H — Deallocate Device (page 2-IN4B-5) 
(AH) = 04H — Send Device SCB (page 2-IN4B-5) 


(AH) = 05H — Send Device Immediate (page 2-IN4B-8) 
(AH) = O6H — Reset Adapter (page 2-IN4B-8) 

(AH) = 07H — Set Time-Out Value (page 2-IN4B-9) 
(AH) = 08H to FFH — Reserved 


Figure 2-30. SCS! Device Functions 


IBM fixed disk drives are defined as having SCSI peripheral type 0, 
512-byte sectors, and nonremovable media. 


BIOS Data Area 


The following flags are located at address hex 40:7B in the BIOS data 
area. These flags indicate the services that are supported through 
Interrupt 4BH. 


Address hex 40:7B 
Bits 7 to 6 - Reserved 
Bit 5 - Operating-system DMA services indicator 
0 - Not supported; all memory is mapped linear = physical 
1 - Supported 
Bit 4 - Reserved 
Bit 3 - Interrupt-4BH-intercepted indicator 
0 - Interrupt vector is not intercepted 
1- Interrupt vector is intercepted 
Bit 2 - Reserved 
Bit 1 - Generic SCSI CBIOS services support 
Q - Interrupt 4BH does not support SCSI 
1 - Interrupt 4BH supports SCSI 
Bit 0 - Reserved 


Wo 


If bit 5 is set to 1, DMA services are available. If bit 5 is set to0, DMA 
services are not available. 


Providers of the operating-system DMA services must set bit 3 when 
hooking into Interrupt 4BH. 


2-IN4B-2 Advanced Services—September 1991 


If bit 3 is set to 1, a program that provides services through Interrupt 
4BH must link into the interrupt chain by saving the interrupt vector 
for Interrupt 4BH and replacing the old vector with the pointer to the 
start of the program’s code. Then, if the program does not provide 
the requested services, it can pass the call to the next link in the 
chain. 


For Personal System/2 systems with Micro Channel architecture, if bit 
3 is set to 0, the following test must be performed: 


If bit 1 of 40:7B is set to 0, 
-or- 
the contents of the Interrupt 4BH vector are 0:0, 
-or- 
the Interrupt 4BH vector contains a segment value of 
hex E000 or hex F000, 


the interrupt vector must not be chained. 


Else, the interrupt vector must be chained. 


If this test indicates that the interrupt vector must not be chained, the 
program puts its pointer into the vector and sets bit 3 to 1; however, if 
it does not provide the requested services, the program must return 
status that indicates that the call is not supported ((AH) = 86H and 
CF= 1). 


(AL) = 00H—Get Device Count 


This function returns the total count of SCSI devices in the system 
for the specified peripheral type. 


(DL) - Device-type indicator 
Bit 7 = 1- Removable media 
Bits 6 to 0 - SCSI peripheral type 


On Return: 
(AH) - Return code 
(CL) - Device count 
CF = 0 - Return code is 0 
= 1- Return code is non 0 
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(AL) = 01H—Get Device Data 


This function returns various parameters for the specified SCSI 
device. 


(DL) - Device-type indicator 
Bit 7 = 1- Removable media 
Bits 6 to 0 - SCSI peripheral type 
(DH) - Device index (range is from 1 to the device count) 


On Return: 
(AL) - Device status 
Bits 7 - Reserved 
Bit 6 = 0 - Scatter/gather supported in hardware 
= 1- Scatter/gather not supported in hardware 
Bit 5 = 1 - Device allocated 
Bit 4 = 0 - Cache buffer not enabled 
= 1- Cache buffer enabled 
Bit 3 = 1 - IBM fixed disk drive (nonremovable media, 
§12-byte sectors) 
Bit 2 = 1- Removable media 
Bit 1 = 1 - Defective device (error during POST) 
Bit 0 = 1- Device not powered-on (during POST) 
(BH) - Level 
Bits 7 to 4 - Reserved 
Bits 3 to 0 - Adapter number 
(BL) - Unit number 
Bits 7 to 4 - Logical unit number 
Bits 3 to 0 - Physical unit number 
(CL) - Time-out value 
Bit 7 = 0 - Time-out count, in seconds 
= 1-Time-out count, in minutes 
Bits 6 to 0 - Time-out count 
(AH) - Return code 
CF = 0- Return code is 0 
= 1- Return code is non 0 


(AL) = 02H—Aliocate Device 


This function returns a device key for the specified SCSI device. 
This device key is unique for each device and is used with the 
Deallocate Device function ((AL) =03H), the Send SCB to Device 
function ((AL)=04H), the Send Immediate Command to Device 
function ((AL) = 05H), the Reset Adapter function ((AL) =O6H), and 
the Set Time-Out Value function ((AL) =07H). 


The value of the device key varies, depending on the 
configuration, the BIOS version, and other factors. Therefore, to 
ensure compatibility, use this function to obtain a valid device 
key. The device key is valid only when the carry flag is set to 0. 


If the device has already been allocated, a device key is not 
returned. 
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(DH) - Device index 
= 0 - Allocate next available device 
= From 1 to the device count - Allocate specified device 
(DL) - Device-type indicator 
Bit 7 = 1- Removable media 
Bits 6 to 0 - SCSI peripheral type 


On Return: 
(AH) - Return code 
(DX) - Device key 
CF = 0 - Return code is 0 
= 1- Return code is non 0 


Note: IBM fixed disk drives are accessible through Interrupt 
13H—Fixed Disk. Any device driver that allocates an IBM 
fixed disk drive through this function must also intercept 
Interrupt 13H requests for that device, or substitute for the 
operating-system device driver that issues the Interrupt 
13H requests. 


(AL) = 03H—Deallocate Device 


This function frees the device that is associated with the specified 
device key so that it can be allocated by another device driver. 
After the device has been deallocated, an error occurs if that 
device key is used. The Allocate Device function must be used to 
regain access to the device. 


(DX) - Device key 


On Return: 
(AH) - Return code 
CF = 0- Return code is 0 
= 1- Return code is non 0 


(AL) = 04H—Send SCB to Device 


This function sends a subsystem control block (SCB) command to 
the specified SCSI device. (Refer to the technical references for 
the SCSI adapter and the device for details on the SCB structure 
and other programming information.) 
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(CL) - SCB type indicator 
Bits 7 to 4 - Reserved 
Bit 3 = 0 - Original chain header or no chain header passed 
(see note on page 2-IN4B-7) 
= 1- Extended chain header passed 
Bit 2 = 0 - 32-bit SCB physical address pointer not passed 
(Si and Di are undefined on input) 
= 1- 32-bit SCB physical pointer passed in (SI,DI) 
Bit 1 = 0- No chain header or extended chain header passed 
(see note on page 2-IN4B-7) 
= 1- Original chain header passed 
Bit 0 = 0- Send SCB (use with all commands except the 
Send Other SCSI SCB command) 
= 1- Send long SCB (use with Send Other SCS! SCB 
command) 
(DX) - Device key 
(ES:BX) - Logical pointer to SCB 
(SI,Dl) - 32-bit physical address pointer to SCB (SI is MSW; 
Dl is LSW; valid when bit 2 of CL is set to 1) 


On Return: 
(AH) - Return code 
(AL) - Error status (see “Return Codes” on page 2-IN4B-10 for a definition 
of this error status) 
CF = 0- Return code is 0 
= 1- Return code is non 0 


Notes: 


1. The Read and Write SCB commands are the primary interface 
to devices such as IBM fixed disk drives. The Send Other 
SCSI command should not be used to read or write to IBM 
fixed disk drives because system data might be lost. 


2. All addresses within the subsystem control block (SCB) are 
physical. Before making a call to BIOS, the calling program 
must translate logical addresses to physical addresses and 
ensure that all subsystem control blocks, termination status 
blocks, and data buffers are locked into memory. See 
Interrupt 4BH, Operating-System DMA Services function 
((AH) = 81H). 
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3. When SCBs are chained, (ES:BX) points to the first SCB. 
Each SCB is built with a chain header, which immediately 
precedes the SCB. The format of the chain header is as 


follows: 

Size Offset Description 

Word ~10H Reserved 

DWord -0CH Logical-pointer data buffer 

Word —0AH Reserved 

Word —08H Reserved 

DWord —04H Logical pointer to scatter/gather list 
(set to 0 if no scatter/gather list) 

Word —02H Reserved 

Word 00H Reserved 

DWord 02H Logical pointer to next SCB header in chain, 
or chain-ending indicator (0) 

Word 06H Reserved 

Word 08H Reserved 

DWord OAH Logical pointer to TSB associated with this SCB 

Word 0EH Reserved 

10H Beginning of SCB 


¢ Achain length of 1 is allowed. 

¢ The chain must have an ending. 

¢ A logical pointer to the next SCB header in the chain equal to 
0 ends the chain. 

¢ The chain header must immediately precede the SCB. 


Bit 2 in (CL) can be set, and the physical address to the first SCB 
can be passed in (SI,DI). However, (ES:BX) and the chain 
headers must still be built and passed. If the linear address of 
the SCB does not equal the physical address, the physica! 
address must be passed to BIOS. See Interrupt 4BH, 
Operating-System DMA Services function ((AH) =81H). 


See “Send Device SCB Chaining” on page 2-IN4B-12 for chaining 
data structures and example. 


To determine the chain-header type, the SCB-indicator bits 1 and 
3 must be evaluated together. There are two types of chain 
headers as input to BIOS: the original header and the extended 
header. It is recommended that all software use the extended 
header as input. Using the extended header ensures portability 
to non-bus-master implementations of SCSI controllers. Bits 1 
and 3 are evaluated as follows: 


¢ When bit 3 is set to 0 and bit 1 is set to 0, no chain header is 
passed. 


¢ When bit 3 is set to 0 and bit 1 is set to 1, the original chain 
header is passed. 
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e When bit 3 is set to 1 and bit 1 is set to 0, an extended chain 
header is passed. 


e When bit 3 is set to 1 and bit 1 is set to 1, an invalid condition 
exists, and an error return code is returned. 


(AL) = 05H—Send Immediate Command to Device 


This function sends an immediate command to the specified SCSI 
device. (Refer to the technical references for the SCSI adapter 
and the device for details on the immediate commands and other 
programming information.) 


(BX) - Word 0 of the immediate command 
(CX) - Word 1 of the immediate command 
(DX) - Device key 


On Return: 
(AH) - Return code 
(AL) - Error status (see “Return Codes” on page 2-IN4B-10 for a definition 
of this error status) 
CF = 0- Return code is 0 
= 1- Return code is non 0 


(AL) = 06H—Reset Adapter 


This function issues a hardware reset to the adapter for the 
specified device. This causes the card to perform power-on 
diagnostic routines to determine whether various components on 
the adapter are functioning properly. All device operations in 
progress on the adapter are terminated. After the reset, BIOS 
restores the device assignments, device time-out values, and the 
device-cache status. 


Note: This function should be used only as part of an 
error-recovery procedure. See “Return Codes” on 
page 2-IN4B-10 to determine when this function should be 
issued. 


(DX) - Device key 


On Return: 
(AH) - Return code 
(AL) - Error status (see “Return Codes” on page 2-IN4B-10 for a definition 
of this error status) 
CF = Q- Return code is 0 
= 1- Return code is non 0 
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(AL) = 07H—Set Time-Out Value 


This function specifies the maximum time that the adapter will 
wait for a device to complete a command. The defauit time-out 
value for each device is 45 seconds. The time-out value is 
specified in bits 6 to 0 of the CL register. Bit 7 determines 
whether the time is in seconds or in minutes. 


If bits 6 to 0 are set to 0, BIOS programs the adapter not to time 
out any commands to the device. On subsequent commands to 
the device, BIOS waits up to 127 minutes for the operation to be 
completed before posting an error. If more time is required, the 
controlling program must chain into interrupt 15H, screen the 
Wait (AX =9000H) and Post (AX= 9100H) calls, and provide the 
correct wait time before allowing BIOS to post an error. 


(CL) - Time-out value 
Bit 7 = 0 - Time-out count, in seconds 
= 1- Time-out count, in minutes 
Bits 6 to 0 - Time-out count 
(DX) - Device key 


On Return: 
(AH) - Return code 
(AL) - Error status (see “Return Codes” on page 2-IN48-10 for a definition 
of this error status) 
CF = 0- Return code is 0 
= 1- Return code is non 0 


(AL) = 08H to FFH—Reserved 
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Return Codes 


The following figure lists the return codes and their meanings. 
Return codes are returned in the AH register. 


Description 


00H Operation Successfully Completed 

01H Invalid BIOS Function or Parameter 

02H Device Not Allocated 

03H Device Already Allocated 

04H Function Not Allowed (see note 1) 

05H Request Refused, Adapter Reset Required 
06H Request Ended in Error (see note 2) 

07H Adapter Reset Failed (see note 2) 

08H Adapter Reconfiguration Failed after Reset 
09H Adapter Time-Out Error 

OAH Adapter in Use (see note 3) 


Extended Header Required to Complete the Request (see note 4) 


Figure 2-31. Return Codes — SCSI Devices 


Notes: 


1. This code is returned when the Set Feature Control immediate 
command is issued. Instead, the device driver must use the Set 
Time-Out Value function ((AL) =07H). 


2. The following defines the error status value in (AL): 


(AL) - Error status 

Bit 7 = 1- Reset adapter before attempting the next command 

Bit 6 = 1- Request command-complete status to get additional 
error-status data 

Bit 5 - Reserved 

Bit 4 = 1- Bits 3 to 0 contain interrupt ID of interrupt 
status register 

Bits 3 to 0 - Interrupt iD of interrupt status register 


3. This code is returned when the adapter is in use. The device 
driver should retry the operation at a later time. 


4. In an operating-system DMA-services environment, this error 
occurs when: 


* No chain header (original or extended) was passed and the 
caller’s termination status block must be filled in, or 


¢ No extended chain header was passed and the caller 
requested a scatter/gather operation on hardware that does 
not support scatter/gather. 
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Programming Considerations 


® 


BIOS tests the device key parameter and the device index 
parameter to protect the integrity of the system. Any calls that 
are directed to BIOS for SCSI devices and have an unrecognized 
function value generate a return code of 01H (Invalid BIOS 
Function or Parameter). 


SCSI devices are controlled by immediate commands or 
subsystem control blocks (SCBs) that are issued to the device. 
These commands contain a function number and other necessary 
parameters. 


If the device driver specifies an SCB command, the device 
performs the command pointed to by (ES:BX). 


If the device driver specifies an immediate command, the device 
performs the 32-bit command that is contained in (CX,BX) 
(CX =MSW; BX=LSW). 


The device driver must ensure that subsystem control blocks and 
any data buffers or termination status block areas that are 
needed for command processing are locked into memory. The 
device driver must also ensure that the correct physical 
addresses are used. 


Before any of the BIOS for SCSI Devices functions are invoked, 
the device driver must test bit 1 of address hex 40:7B. If this bit is 
set to 1, the SCSI services are available, and the bit no longer 
has to be tested. 


The AX register and the carry flags are used to return the status 
of the operation. The carry flag signals the status of each 
Operation on return from BIOS. If the carry flag is set to 0, the 
operation was successful, and (AH) is set to 0. If the carry flag is 
set to 1, the operation was not successful, and (AH) contains a 
return code as defined in “Return Codes” on page 2-IN4B-10. if 
more information is needed, use the Request Sense command. 


Programming Example 


The following is an example of a procedure that uses these BIOS 
routines. The scenario describes a peripheral-type device driver that 
does not have information about how many devices of that type are 
attached. 
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1. Determine how many devices of that type are attached: 


Get Device Count function 
(DL) = 81H - Specifies removable-media tape drive 


On Return: 
CF =0 
(CL) = 03H - Three devices 


2. Get the device key for the specific drive. The device key is 
unique for each drive in the system: 


Allocate Device function 
(DL) = 81H 
(DH) = 01H - First tape drive 


On Return: 
CF=0 
(DX) = Device key for first tape drive in the system 


3. Send a Device Inquiry command using BIOS routines with 
(DX) = device key, and check the device-dependent information to 
determine whether it is the correct device. If it is not: 


Deallocate Device function 
(DX) = Device key 


Allocate Device function 


(DL) = 81H 
(DH) = 02H - Next tape 


Send Device SCB Chaining 


Before chaining subsystem control blocks: 


| @ When bit 3 of the CL register is set to 1, the extended SCB chain 
| header is being used. 


¢ (ES:BX) is the logical! pointer to the first SCB. This pointer must 
always exist. It points to the SCB, not to the SCB chain header. 


e (SI,Di) is the 32-bit physical pointer to the first SCB. Bit 2 of the 
CL register is set to 1. If the SCB is not in linear-equals-physical 
memory, this information must be provided. 
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¢ The following describes the data structures that must be used 
when SCBs are chained: 


Word 
DWord 
Word 
Word 
DWord 


Word 
Word 
DWord 


Word 
Word 
DWord 


Word 


Offset 


10H 
—0CH 
—0AH 
—08H 
—04H 


02H 
00H 
02H 


06H 
08H 
OAH 


OEH 
10H 
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Description 


Reserved 
Logical-pointer data buffer 
Reserved 
Reserved 
Logical pointer to scatter/gather list 
(set to 0 if no scatter/gather list) 
Reserved 
Reserved 
Logical! pointer to next SCB header in chain 
or chain-ending indicator (0) 
Reserved 
Reserved 
Logical pointer to TSB that is associated 
with this SCB 
Reserved 
Beginning of SCB 
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BIOS Send Device SCB Chain Example 


Physical Pointer 
(SI,DI) 
(only if CL(2)=1) 


1 
Logical Ptr 
Data Bufferl 
Logical Ptr 
Scat/Gath Lst1l 
Logical Ptr 
SCB2 Header 
Logical Ptr 
TSB1 


SCB1 
Physical Ptr 
TSB1 
Physical Ptr 
SCB2 


N 
Logical Ptr 
Data BufferN 
Logical Ptr 
Scat/Gath LstN 
End of Chain 

(0) 


Logical Ptr 
TSBN 


Logical Pointer 
(ES:BX) 


“+> 


TSBO 


Physical Ptr 
TSBN 


End of Chain 
(0) 
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(AH) = 81H—Operating-System DMA Services 


This interface is provided by the operating system, not by BIOS or 
ABIOS. It enables communication of physical address information 
between the operating system and other programs. This interface 
provides a means for: 


¢ Identifying the version and functional level of the support that is 
provided 
Identifying the physical address of an I/O buffer 
Determining whether the memory for an I/O buffer is a contiguous 
block 

¢ Locking and unlocking the I/O buffer into a specific memory 
space 

¢ Remapping memory to put the I/O buffer into a contiguous 
memory space 
Allocating a contiguous block of memory for I/O buffers 
Copying data to or from the allocated buffers. 


The following is a summary of the Operating-System DMA Services 
functions. 


(AH) = OOH to 001H — Reserved 

(AH) = 02H — Return DMA-Service Parameters (page 2-IN4B-20) 
(AH) = 03H — Lock I/O Buffer (page 2-IN4B-20) 

(AH) = 04H — Untock I/O Buffer (page 2-IN4B-22) 

(AH) = 05H — Scatter/Gather Lock Buffer (page 2-IN4B-23) 

(AH) = 06H — Scatter/Gather Unlock Buffer (page 2-IN4B-25) 
(AH) = 07H — Request Operating-System Buffer (page 2-IN4B-9) 


(AH) = 08H — Release Operating-System Buffer (page 2-IN4B-26) 

(AH) = 09H — Copy Data into Operating-System Buffer (page 2-IN4B-27) 
(AH) = OAH — Copy from Operating-System Buffer (page 2-IN4B-27) 
(AH) = OBH — Disable DMA Translation (page 2-IN4B-28) 

(AH) = 0CH — Enable DMA Translation (page 2-IN4B-28) 

(AH) = ODH to FFH — Reserved 


Figure 2-32. Operating-System DMA Services Functions 


Micro Channel bus-master adapters can access memory locations 
without assistance from the operating system and without using the 
system microprocessor or DMA controller. 


When the system microprocessor is operating in the protected (virtual 
address) mode, the device drivers for these adapters communicate 
with the operating system to exchange address information. In this 
mode, the physical address of the data buffers that are used in I/O 
operations is not available to BIOS or device-driver routines that 
initiate the I/O operations. 
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Operating-System Requirements 


Any operating system that supports operating-system DMA services 
must provide the following minimum requirements: 


Functions hex 02 through hex OC describe the minimum subset of 
DMA services that must be implemented by the provider. 


The operating system must support either 1/O buffer allocation or 
automatic page remapping, but it can provide both services. It 
I/O buffer allocation is supported, the minimum size of the buffer 
is 16KB. 


During initialization of an operating system that provides DMA 
services, the device drivers must remain at the 
previously-allocated memory addresses. Operating systems that 
provide DMA services can implement an interface that allows for 
the device drivers to be relocated. However, ail in-process 1/O 
transactions must be completed before the device drivers are 
relocated. 


The operating system must indicate that these DMA services are 
provided in the BIOS data area by setting bit 5 at address hex 
40:7B to 1. 


BIOS locks and unlocks the extended BIOS data area as required. 
When DMA services are provided (bit 5 at address hex 40:7B is 
set to 1), the provider must ensure that requests to lock the 
extended BIOS data area are successful. When the extended 
BIOS data area is locked, it is contiguous, and the physical 
address is available in the Physical Address field of the DMA 
descriptor structure (DDS). 


Interrupt 15H, Return Extended BIOS Data Area Segment Address 
function ((AH) =C1H) returns the address segment for the 
extended BIOS data area. The first byte (offset hex 00) is the 
length of the extended BIOS data area, in KB. The extended 
BIOS data area has an assumed offset of hex 0. interrupt 15H, 
Return System Configuration Parameters function ((AH) = COH) 
indicates whether the extended BIOS data area has been 
allocated. 
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BIOS Data Area 


The following flags are located at address hex 40:7B in the BIOS data 
area. These flags indicate the services that are supported through 
Interrupt 4BH. 


Address hex 40:7B 
Bits 7 to 6 - Reserved 
Bit 5 - Operating-system DMA services indicator 
0 - Not supported; all memory is mapped linear = physical 
1- Supported 
Bit 4 - Reserved 
Bit 3 - Interrupt-4BH-intercepted indicator 
= 0 - Interrupt vector is not intercepted 
= 1- Interrupt vector is intercepted 
Bit 2 - Reserved 
Bit 1 - Generic SCSI CBIOS services support 
= 0 - Interrupt 4BH does not support SCSI 
= 1- Interrupt 4BH supports SCSI 
Bit 0 - Reserved 


If bit 5 is set to 1, DMA services are avaitable. If bit 5 is set to 0, DMA 
services are not available. 


Providers of the operating-system DMA services must set bit 3 when 
hooking into interrupt 4BH. 


If bit 3 is set to 1, a program that provides services through Interrupt 
4BH must link into the interrupt chain by saving the interrupt vector 
for Interrupt 4BH and replacing the old vector with the pointer to the 
start of the code for the program. Then, if the program does not 
provide the requested services, it can pass the call to the next link in 
the chain. 


For Personal System/2 systems with Micro Channel architecture, if bit 
3 is set to 0, the following test must be performed: 


if bit 1 of 40:7B is set to 0, 
igr= 
the contents of the Interrupt 4BH vector are 0:0, 
_~or—- 
the Interrupt 4BH vector contains a segment value of 
hex E000 or hex F000, 


the interrupt vector must not be chained. 


Else, the interrupt vector must be chained. 
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If this test indicates that the interrupt vector must not be chained, the 
program puts its pointer into the vector and sets bit 3 to 1; however, if 
it does not provide the requested services, the program must return 
status that indicates that the cail is not supported ((AH) = 86H and 
CF=1). 


Programming Considerations 


* Before attempting to physically address memory, device drivers 
and other programs that use the operating-system DMA services 
must determine whether physical-address services are available. 
At initialization, the device driver tests bit 5 (physical-address 
services indicator) at address hex 40:7B to make this 
determination. 


If bit 5 is set to 1, the services are available, and the device driver 
must use the services to lock the required buffers into memory 
and to get the physical addresses of the buffers. Any locked 
buffers must be unlocked after the I/O operation is complete. 

This bit is retested before each operation that accesses memory. 


If bit 5 is set to 0, the services are not available, and the device 
driver requests a block of memory to use as buffer space. After 
the buffer space has been allocated, that space remains locked 
into memory as jong as the driver remains installed. The device 
driver does not retest bit 5 for accesses to buffers that have been 
allocated in this manner. However, if the device driver receives 
an address that is not within its boundaries, the device driver 
must retest bit 5 and use the physical-address services, if they 
are available. 


e With the exception of the AX register, the contents of al! registers 
and the values in the DMA descriptor structure must be 
preserved, unless otherwise noted. If the carry flag is set to 1, 
the AL register contains an error code. If the carry flag is set to 
0, the AH and AL registers are undefined, unless otherwise noted. 
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The DMA Descriptor Structure (DDS) 


The DMA descriptor structure (DDS) is used to pass parameters 
between the operating system and the calling program. The DDS can 
be constructed in the memory of the calling program or on the stack. 
Reserved fields in the DDS must be set to 0. 


The format of the DMA descriptor structure is as follows: 


Size Offset Description 
DWord 00H Buffer size (in bytes) 
DWord 04H Offset 


This is a 32-bit offset. If a 16-bit offset is specified, 
the calling program must set the word at offset hex 06 to 0. 
If the Segment/Selector field is set to 0, the offset is a 
32-bit linear offset. 
Word 08H Segment/selector 
This is the segment or selector of the buffer. If this field 
is set to 0, the Offset field contains the 32-bit linear 
address of the buffer. 
Word OAH Buffer ID 
This field is filled in by the provider of DMA services. 
When this field is set to 0, a buffer was not allocated. 
Word OCH Physical address 
This is the 32-bit value of the physical address that can be 
used to program the DMA controller or Bus-Master Address 
register. This field is filled in by the provider of 
DMA services. 


(AL) = 00H to 01H—Reserved 


On Return: 
(AL) - Error code 
= OFH - Function not supported 
(CF) = 1 - Operation failed 
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(AL) = 02H—Return DMA-Service Parameters 


This function returns the version level of DMA services, the 
operating-system identification, the DMA-service revision level, 
hardware address restrictions, the maximum buffer size that is 
available from the operating system, and the automatic 
memory-remapping-support indicator. 


(DX) - Flags 
All bits are reserved and must be set to 0 


On Return: 
(AH) - Major specification version number (binary) 
(AL) - Minor specification version number (binary) 
(BX) - Product number 
(CX) - Product revision number 
(SI:DI) - Maximum single operating-system buffer size 
that can be requested from the operating system 
(in bytes). A value of 0 indicates that no 
operating-system buffer is available or supported. 
(DX) - Flags 
Bit 0 - Memory address space size 
Q- Memory addresses greater than 1MB exist 
1- All memory addresses are less than 1MB 
Bit 1 - Physical buffer/remap buffer location 
= 0- Physical buffer/remap buffer can be above 1MB 
= 1- Physical buffer/remap buffer is below 1MB 
Bit 2 - Automatic page remapping support 
0 Automatic page remapping is not supported 
1 Automatic page remapping is supported 
Bit 3 - Memory-paging indicator 
= 0- Memory is not physically contiguous 
= 1- All memory is physically contiguous 
Bits 4 to 15 - Reserved (set to 0) 
CF = 0- Operation successfully completed 


(AL) = 03H~—Lock I/O Buffer 


This function determines whether the I/O buffer for the calling 
program is in contiguous physical memory. If it is, the physical 
address of the I/O buffer is returned in the DMA descriptor 
structure (DDS), and the buffer is locked in memory. 


A locked buffer must be unlocked after the I/O operation is 
completed, either successfully or unsuccessfully. 


Automatic page remapping, if supported, can be enabled or 
disabled. If automatic page remapping is enabled, the operating 
system moves the buffer pages to force the I/O buffer into 
contiguous physical memory. Automatic remapping might reduce 
performance because of the movement of data in memory. 
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An option is provided to allocate a buffer in the memory of the 
operating system if the buffer for the calling program is not in 
contiguous memory. The calling program can also specify that 
the data is to be copied from the buffer of the calling program into 
the allocated buffer. The physical address that is returned in the 
DDS points to the allocated buffer that contains the data for the 
calling program. 


(DX) - Flags 
Bit 0 - Reserved 
Bit 1 - Automatic data copy indicator 
= 0 - Do not copy data into operating-system buffer 
= 1- Copy data into operating-system buffer 
(ignored if bit 2=1) 
Bit 2 - Automatic buffer-allocation indicator 
= 0- Allocate buffer 
= 1- Do not allocate buffer 
Bit 3 - Automatic remapping request indicator 
0 - Automatic remapping requested 
1- Do not remap memory 
Bit 4 - 64KB I/O buffer boundary restriction indicator 
0 - No 64KB physical address boundary restrictions 
1 - Buffer must not cross 64KB physical address boundary 
128KB I/O buffer boundary restriction indicator 
0 - No 128KB physical address boundary restrictions 
= 1- Buffer must not cross 128KB physical address boundary 
Bits 6 to 15 - Reserved (set to 0) 
(ES:Dl) - Pointer to DMA descriptor structure (DDS) 


Bit 


a 
' 


The calling program must fill in the Buffer Size field, the Offset 
field, and the Segment/Selector field in the DDS. 


On Return: 
(AL) - Error code 
= O1H - Specified buffer is not in contiguous memory, 
or automatic remapping was not successful 
= 02H - Buffer crossed a physical alignment boundary 
= 03H - Unable to lock pages; insufficient memory 
(virtual-memory systems only) 

= O5H - Requested buffer size too large 

O6H - Buffer currently in use 

07H - Invalid memory buffer specified 

= 10H - Reserved flag bits set in (DX) 

CF = 0- Operation successfully completed. 
Buffer memory is locked. 
The Physical Address field of the DDS contains the 
Starting physical address of the buffer. 
The Buffer ID field contains the ID of the allocated 
buffer, or the Buffer ID field contains 0 if no 
buffer was allocated. 

= 1- Operation failed. 

Buffer memory is not locked 
The Buffer Size field of the DDS contains the 
maximum contiguous length, in bytes. 
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Notes: 


1. If the DMA services return a physical address that is not 
compatible with the DMA controller or the bus-master 
addressing capabilities, the calling program can unlock the 
1/O buffer and request that the DMA services allocate a buffer 
from the free memory of the operating system (see (AL) =07H 
on page 2-IN4B-25). 


2. If an operating-system buffer is not available, the calling 
program can enable interrupts, and a wait loop can 
repeatedly attempt to allocate a buffer. 


3. After the I/O operation has been initiated, a wait loop with 
interrupts enabled can be used to wait for the completion of 
the I/O operation. The buffer can be released on the 
hardware-interrupt level, enabling other tasks that are 
waiting for buffer space to continue. 


4. This function can be called repeatedly. 
(AL) = 04H—Unlock I/O Buffer 
This function unlocks a previously-locked I/O buffer. 


(DX) - Flags 
Bits 15 to 2 - Reserved (set to 0) 
Bit 1 - Automatic data copy indicator 
= 0- Do not copy data 
= 1- Copy data from the operating-system buffer to 
a buffer of the calling program 
Bit 0 - Reserved (set to 0) 
(ES:DI) - Pointer to DMA descriptor structure (DDS) 


The calling program must return a DDS with the buffer size, 
physical address, and buffer 1D of a buffer that is 
currently locked. 


On Return: 
(AL) - Error code 
= 08H - Memory was not locked 
= OAH - Invalid buffer ID 
= 10H - Reserved flag bits set in (DX) 
CF = 0- Operation successfully completed. 
Memory is unlocked; the buffer is no longer valid. 
= 1- Operation failed. 
All memory remains locked 
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(AL) = 05H—Scatter/Gather Lock Buffer 


This function determines the physical addresses of the memory 
areas that make up the buffer of the calling program and locks 
each of these memory areas. The list of physical addresses and 
the size of each area are returned to the calling program in the 
DMA descriptor structure (DDS). The calling program can use 
these parameters to program bus masters that support the 
scatter/gather functions or to break up a bus-master or DMA-I/O 
operation into multiple operations. 


(DX) - Flags 
Bit 6 - Return physical address/page table entries 

0 - Return physical addresses 
1 - Return page table entries 
Bit 7 - Allocate page indicator (only if bit 6 is set to 1) 
0 - All pages must be allocated and present 
1 - Lock only those pages that are present. 
All page-table entries must be returned in the 
DDS, whether they are present or not. 
The calling program must determine the presence 
or absence of pages in memory from bit 0 of the 
page-table entry: 

Bits 31 to 12 - Page-frame address if bit O= 1. 

All set to 0 if bit O=0. 
Bits 11 to 1 - Reserved (set to 0) 
Bit 0 - Presence indicator 
= 0- Page is absent from memory 
= 1- Page is present in memory 

All other bits are reserved and must be set to 0. 

(ES:Dl) ~ Pointer to scatter/gather DDS 


oil 


When bit 6 is set to 0, the DMA descriptor structure returns the 
physical addresses of the memory areas: 


Size Offset Description 

DWord 00H Buffer size, in bytes 

DWord 04H Offset 

Word 08H Segment/selector 

Word OAH Reserved 

Word OCH Number of physical buffers available 
Word OEH Number of physicai buffers that are used 
DWord 10H Buffer 0 physical address 

DWord 14H Buffer 0 size, in bytes 

DWord 18H Buffer 1 physical address 

DWord 1CH Buffer 1 size, in bytes 

DWord 10H+(nx8) Buffer n physical address 

DWord 14H+(nx8) Buffer n size, in bytes 
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When bit 6 is set to 1, the DMA descriptor structure returns the 
page-table entries of the memory areas: 


Size Offset Description 

DWord 00H Buffer size, in bytes 

DWord 04H Offset 

Word 08H Segment/selector 

Word OAH Reserved 

Word 0CH Number of page-table entries available 
Word OEH Number of page-table entries that are used 
DWord 10H Page-table entry 0 

DWord 14H Page-table entry 1 

DWord 10H+(nx4)  Page-table entry n 


The calling program must fill in the Buffer Size field, the 
Segment/Seiector field, the Offset field, and the Number of 
Physical Buffers/Page-Table Entries Available field. 


The maximum number of physical buffers that are required can 
be computed as: 


(Linear Address AND OFFFH) + Buffer Size in hexadecimal + OFFFH 


1000H 


On Return: 
(AL) = Error code 
03H = Unable to lock pages, insufficient memory 
07H = Invalid memory buffer specified 
OSH = Number of physical buffers/pages is greater than the 
table lengih. Ojfset hex GE of the ODS contains the 
number of entries that are actually required to 
represent the buffer of the calling program. 
10H = Reserved flag bits set in (DX) 
CF = 0- Operation successfully completed. 
Offset hex OE of the DDS contains the number of physical 
buffers or page-table entries that are filled in. 
If bit 6 of (DX) is set to 1, the low 12 bits of (BX) 
contain the offset in the first page to the start of the 
buffer. 
The high 4 bits are set to 0. 
= 1 - Operation failed. 
Memory is not locked. 
The Buffer Size field of the DDS contains the maximum 
length, in bytes, that can be locked and described in 
the DDS. 
Either the list of physical addresses and their sizes or 
the page-table entries are undefined. 
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(AL) = 06H—Scatter/Gather Untock Buffer 


This function unlocks a buffer that was locked by the 
Scatter/Gather Lock Buffer function ((AL) = 05H). 


(DX) - Flags 
All bits are reserved and must be set to 0. 
(ES:Dl) - Pointer to the extended DDS that was used when 
the Scatter/Gather Lock Buffer function was called 


On Return: 
(AL) - Error code 
= 08H - Memory was not locked 
= 10H - Reserved flag bits set in (DX) 
CF = 0- Operation successfully completed; memory is unlocked 
= 1- Operation failed 


(AL) = 07H—Request Operating-System Buffer 


This function allocates and locks a buffer of physically-contiguous 
memory from the operating-system free memory. If requested, 
data is copied from the buffer of the calling program into the 
buffer that was allocated by the operating system. 


The data must be copied to or trom the operating-system buffer 
before the Release Operating-System Buffer function ((AL) =08H) 
is called. The physical address of the buffer is invalid after the 
buffer is released. 


(DX) - Flags 
Bit 1 - Automatic data copy indicator 
= 0- Do not copy data 
= 1- Copy data into the operating-system buifer 
All other bits are reserved and must be set to 0. 
(ES:D!) - Poinier to DMA descriptor structure (DDS) 


The calling program must fill in the Buffer Size field. If 
automatic copy is selected, the calling program must also fil! 
in the Segment/Selector field and the Offset field to point to 
the data that is to be copied into the allocated buffer. 
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On Return: 
(AL) - Error code 
04H - No buffer available 
05H - Buffer size too large 
O6H - Buffer currently in use 
= 07H - Invalid memory buffer specified 
= 10H - Reserved flag bits set in (DX) 
CF = 0 - Operation successfully completed 
The Physical Address field of the DDS contains the 
starting physical address of the buffer. 
The Buffer Size field of the DDS specifies the size 
of the buffer. 
The Buffer ID field of the DDS contains the ID of 
the allocated buffer. 
If automatic copy is selected, data is copied into 
the operating-system buffer. 
= 1- Operation failed 


tou u 


Notes: 


1. If an operating-system buffer is not available, the calling 
program can enable interrupts, and a wait loop can 
repeatedly attempt to allocate a buffer. 


2. After the I/O operation has been initiated, a wait loop with 
interrupts enabled can be used to wait for the completion of 
the |/O operation. The buffer can be released on the 
hardware-interrupt level, enabling other tasks that are 
waiting for buffer space to continue. 


3. This function can be called repeatedly. 
(AL) = 08H—Release Operating-System Buffer 


This function releases an operating-system buffer that was 
previously allocated. The physical address is invalid after the 
buffer is released. 


(DX) - Flags 
Bit 1 - Automatic data copy indicator 
= 0- Do not copy data 
= 1- Copy data out of the operating-system buffer 
All other bits are reserved and must be set to 0. 
(ES:DI) - Pointer to DMA descriptor structure (DDS) 


The calling program must return a pointer to a DDS that 
contains a Buffer ID field of the previously-allocated buffer. 


On Return: 
(AL) - Error code 
= QAH - Invalid buffer ID 
= 10H - Reserved flag bits set in (DX) 
CF = 0 - Operation successfully completed 
= 1- Operation failed 
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(AL) = 09H—Copy Data into Operating-System Buffer 


This function copies data from the buffer of the calling program 
into the buffer that has been allocated by the operating system to 
prepare for an I/O write operation. 


(DX) - Flags 
All bits are reserved and must be set to 0. 
(ES:DI) - Pointer to DMA descriptor structure (DDS) 


The calling program must fill in the Buffer ID field, the 

Buffer Size field, the Segment/Selector field, and the Offset 
field to specify the source address to copy from. The Buffer 
Size field of the DDS determines the number of bytes that are 
to be copied. 


(BX:CX) - Starting offset in operating-system buffer 
to be copied 


On Return: 
(AL) - Error code 
= OAH - Invalid buffer ID 
= OBH - (Copy count + offset) is greater than the 
buffer size 
= 10H - Reserved flag bits set in (DX) 
CF = 0- Operation successfully completed 
= 1- Operation failed 


(AL) = OAH—Copy from Operating-System Buffer 


This function copies data from the buffer that has been allocated 
by the operating system into the buffer of the calling program 
after an I/O read operation. 


(DX) - Flags 
All bits are reserved and must be set to 0. 
(ES:DI) - Pointer to DMA descriptor structure (DDS) 


The calling program must fill in the Buffer ID field, the 

Buffer Size field, the Segment/Selector field, and the Offset 
field to specify the destination address to copy to. The Buffer 
Size field of the DDS determines the number of bytes that are 
to be copied. 


(BX:CX) - Starting offset in operating-system buffer 
to be copied 
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On Return: 
(AL) - Error code 
= OAH - Invalid buffer ID 
= OBH - (Copy count + offset) is greater than the 
buffer size 
10H - Reserved flag bits set in (DX) 
0 - Operation successfully completed 
= 1- Operation failed 


Cc 


(AL) = OBH—Disable DMA Translation 


This function disables the operating-system function that traps the 
DMA I/O ports and remaps the buffer address to a physical 
address. BIOS and device drivers that use the DMA services to 
determine the physical address of I/O buffers must disabie the 
automatic DMA translation by calling this function. 


A disable count is maintained. Each disable call must have a 


corresponding enable call before automatic DMA translation is 
enabled. 


(BX) - DMA channel number 
(DX) - Flags 
All bits are reserved and must be set to 0. 


On Return: 
(AL) - Error code 
= OCH - Invalid DMA channel number 
= QODH - Disable-count overflow 
= 10H - Reserved flag bits set in (DX) 
CF = 0- Operation successfully completed 
= 1- Operation failed 


(AL) = OCH—Enable DMA Translation 
This function enables automatic DMA translation. 


A disable count is maintained. Each disable call must have a 


corresponding enable call before automatic DMA translation is 
enabled. 


(BX) - DMA channel number 


(DX) - Flags 
All bits are reserved and must be set to 0. 
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On Return: 
(AL) - Error code 
= 0CH - Invalid DMA channel number 


= OEH - Disable-count underflow (was not previously 
disabled; count remains 0) 
10H - Reserved flag bits set in (DX) 
CF = 0 - Operation successfully completed 
= 1- Operation failed 
ZF = 0 - Disable count is not equal to 0 
= 1- Disable count is equal to 0 


(AL) = 0DH to FFH—Reserved 


All registers are reserved (set to 0). 


On Return: 
(AL) - Error code 


= OFH - Function not supported 
CF = 1 - Operation failed 
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Error Codes and Option Flags 


The following figure lists the error codes and their meanings. Error 
codes are returned in the AL register. 


Description 


Specified buffer was not in contiguous memory 
Buffer crossed a physical alignment boundary 
Unable to lock pages 

No buffer available 

Buffer too large 

Buffer currently in use 

invalid memory buffer specified 


Buffer was not locked 

Number of physical pages was greater than table length 
Invalid buffer 1D 

Copy out of buffer range 

Invalid DMA channel number 

Disable-count overflow 

Disable-count underflow 

Function not supported 

Reserved flag bits set in (DX) 


Figure 2-33. Error Codes — Operating-System DMA Services 


The following figure lists the option flags. Option flags are returned 
in the DX register. 


Lock and return presently-available pages 
Return physical address/page table entries 
128KB '/O-buffer boundary restriction indicator 
64KB |/O-buffer boundary restriction indicator 


Automatic remapping request indicator 
Automatic buffer allocation indicator 
Automatic data-copy indicator 


Figure 2-34. Option Flags — Operating-System DMA Services 


2-IN4B-30 Advanced Services—September 1991 


Interrupt 70H—Real-Time Clock Interrupt 


For AT, PC/XT Model 286, and Personal System/2 products except 
Model 25: 


This interrupt handler services the periodic and alarm interrupt 
functions from the real-time clock. 


Perlodic function — When activated, the interrupt occurs 
approximately 1024 times per second. The interrupt handler 
decreases the doubleword microsecond counter by 976 
microseconds (1/1024 of a second). When the counter 
becomes less than or equal to 0, bit 7 of the designated 
location is set to hex 80. For Interrupt 15H, Event Wait 
function ((AH) = 83H), the designated location is provided by 
the user. For Interrupt 15H, Wait function ((AH) = 86H), the 
designated location is bit 7 of BIOS data area hex 40:A0 (Wait 
Active Flag). 


Alarm function — When activated, the interrupt occurs at the 
specified time, and a software Interrupt 4AH is issued. The 
user must point Interrupt 4AH to an alarm routine before 
setting Interrupt 1AH, Real-Time Clock Alarm function 

((AH) = 06H). 


For alt others, the real-time clock interrupt is not supported. 


Notes: 


1. The PC Convertible supports the Periodic and Alarm Interrupt 
functions, but the real-time clock interrupt generates a 
nonmaskable interrupt, rather than invoking Interrupt 70H. 
Additionally, the PC Convertible uses the real-time-clock update 
ended interrupt function (one interrupt per second) when certain 
system profiles are enabled. 
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2. For Personal System/2 Model 30, the Periodic Interrupt function is 
not supported. 
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Notes: 
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Section 3. BIOS Data Areas 


The BIOS data areas are allocated specifically as work areas for 
system BIOS and adapter BIOS. The BIOS routines use 256 bytes of 
memory from absolute address hex 400 to hex 4FF. A description of 
the BIOS data areas follows. 


Address 
(Hex) Function : Size 


40:00 RS-232C communication line 1 port base Word 
address 


40:02 RS-232C communication line 2 port base Word 
address 


40:04 RS-232C communication line 3 port base Word 
address 


40:06 RS-232C communication line 4 port base Word 
address 


The RS-232C communication line port base address fields can be initialized 
to 0 by the POST if the system configuration contains less than four serial 
ports. The POST never puts 0 in the RS-232C communication line port base 
address table between two valid RS-232C communication line port base 
addresses. 


Figure 3-1. RS-232C Port Base Address Data Area 
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Address 
(Hex) Function Size 


40:08 Printer 1 port base address Word 


40:0A Printer 2 port base address Word 


40:0C Printer 3 port base address Word 


40:0E Reserved Word 


Exception: 
40:0E Printer 4 port base address (PC, PC/XT, AT, Word 
and PC Convertible) 


Note: The printer port base address fields can be initialized to 0 by the POST if 
the system configuration contains less than four parallel! ports. The POST 
never puts 0 in the printer port base address table between two valid 
printer port base addresses. 


Figure 3-2. Printer Port Base Address Data Area 


Address 
(Hex) Function 


40:10 Installed hardware 
Bits 15, 14 Number of printer adapters 
Bit 13 Reserved 
Bit 12 Reserved 
Bits 11 to 9 Number of RS-232C adapters 
Bit 8 Reserved 
Bits 7, 6 Number of diskette drives (0-based) 
Bits 5, 4 Video mode type (values are binary) 
= 00 - Reserved 
= 01 - 40x25 color 
= 10 - 80x25 color 
= 11- 80x25 monochrome 
Bit 3 Reserved 
Bit 2 Pointing device 
Bit 1 Math coprocessor 
Bito IPL diskette 


Exceptions: 
Bit 13 Internal modem (for PC Convertible and 
Personal System/2 Model 55 LS) 
Bit 2 Reserved (for PC, PC/XT, AT, and PC 
Convertible) 


Note: Refer to Interrupt 11H for equipment return information. 


Figure 3-3. System Equipment Data Area 
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Address 
(Hex) Function 


40:12 Reserved 


Exceptions: 
40:12 Power-on self-test status (for PC Convertible 
only) 
POST system flag (for Personal System/2 
Model 25 only) 
Real-time clock (RTC) installed 
Optional memory failed; memory remapped 


Figure 3-4. Miscellaneous Data Area 1 


Address 
(Hex) Function 


40:13 Memory size, in KB (range of OKB to 640KB) 


40:15, 40:16 Reserved 


Figure 93-5. Memory Size Data Area 
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Address 
(Hex) Function 


40:17 Keyboard contro! 

Bit 7 Insert locked 

Bit 6 Caps Lock locked 

Bit 5 Num Lock locked 

Bit 4 Scroll Lock locked 

Bit 3 Alt key pressed 

Bit 2 Ctrl key pressed 

Bit 1 Left Shift key pressed 

Bit 0 Right Shift key pressed 
Note: For 101/102-key keyboard support, bits 2 and 3 are set if either or both the 

Alt key and the Ctri key are pressed. 


Keyboard control Byte 
Insert key pressed 
Caps Lock key pressed 
Num Lock key pressed 
Scroll Lock key pressed 
Pause locked 
SysRq key pressed 
Left Alt key pressed 
Left Ctri key pressed 


Alternate keypad entry 
Keyboard buffer head pointer 


Keyboard buffer tail pointer 


Keyboard buffer 


Figure 3-6. Keyboard Data Area 1 
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Address 
(Hex) Function 


40:3E Recalibrate status 

Bit7 Interrupt flag 

Bit 6 Reserved 

Bit 5 Reserved 

Bit 4 Reserved 

Bit 3 Recalibrate drive 3 
Bit 2 Recalibrate drive 2 
Bit 1 Recalibrate drive 1 
Bit oO Recalibrate drive 0 


40:3F Motor status 

Bit7 Write/read operation 

Bit 6 Reserved 

Bits 5, 4 Diskette drive select status (values in 
binary) 
= 00 - Diskette drive 0 selected 
= 01 - Diskette drive 1 selected 
= 10 - Diskette drive 2 selected 
= 11 - Diskette drive 3 selected 
Diskette drive 3 motor-on status 
Diskette drive 2 motor-on status 
Diskette drive 1 motor-on status 
Diskette drive 0 motor-on status 


Motor off counter 


Last diskette drive operation status 
= 00H - No error 
= 01H - Invalid diskette drive parameter 
02H - Address mark not found 
03H - Write-protect error 
= 04H - Requested sector not found 
= 06H - Diskette change line active 
= 08H - DMA overrun on operation 
= 09H - Attempt to DMA across a 64KB 
boundary 
OCH - Media type not found 
10H - CRC error on diskette read 
20H - General controller failure 
30H - Drive does not support media 
sense 
31H - No media in drive 
= 32H - Drive does not support media 
type 
40H - Seek operation failed 
80H - Time-out 
= AAH - Diskette drive not ready 


Figure 3-7 (Part 1 of 2). Diskette Drive Data Area 
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Address 
(Hex) Function 


40:42 Diskette-drive controller status bytes 


Figure 3-7 (Part 2 of 2). Diskette Drive Data Area 


Address 

(Hex) Function Size 

40:49 Display mode set Byte 

40:44 Number of columns Word 
40:46 Length of regen buffer, in bytes Word 
40:4E Starting address in regen buffer Word 
40:50 Cursor position page 1 Word 
40:52 Cursor position page 2 Word 
40:54 Cursor position page 3 Word 
40:56 Cursor position page 4 Word 
40:58 Cursor position page 5 Word 
40:5A Cursor position page 6 Word 
40:50 Cursor position page 7 Word 
40:5E Cursor position page 8 Word 


40:60 


Cursor type 


40:62 Display page 


40:63 


Display controller base address 


40:65 Current setting of 3x8 register 


40:66 Current setting of 3x9 register 


Figure 3-8. Video-Contro/ Data Area 1 
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Address 
(Hex) Function 


40:67 Reserved 
40:68 Reserved 


Exception: 

40:67 Pointer to reset code upon system reset with 
memory preserved (for Personal System/2 
products except Model 25 and Model 30) 
Reset flag at hex 40:72 = 4321H 


Figure 3-9. System Data Area 1 


Address 
(Hex) Function 


40:6C Timer counter 
40:70 Timer overflow 


(if nonzero, the timer has counted past 24 
hours.) 


Figure 3-10. System-Timer Data Area 


Address 
(Hex) Function 


40:71 Break key state 
Bit 7 = 1- Break key pressed 
= 0 - Break key not pressed 


40:72 Reset flag 
= 1234H - Bypass memory test 

4321H - Preserve memory (for Personal 
System/2 products except Model 25 
and Model 30) 

5678H - System suspended (for 
PC Convertible) 

9ABCH - Manufacturing test mode 
(for PC Convertible) 

ABCDH - System POST loop mode 
(for PC Convertible) 


Figure 3-11. System Data Area 2 
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Address 
(Hex) Function 


40:74 Last fixed disk drive operation status 
00H = No error 
01H = Invalid function request 
02H = Address mark not found 
03H = Write protect error 
04H = Sector not found 
O5H = Reset failed 
O7H = Drive parameter activity failed 
08H = DMA overrun on operation 
OSH = Data boundary error 
OAH = Bad sector flag detected 
OBH = Bad track detected 
ODH = invalid number of sectors on 
format 
OEH = Control data address mark 
detected 
OFH = DMA arbitration level out of 
range 
Uncorrectable ECC or CRC error 


fon 


tobe aod a 


10H 


11H = ECC corrected data error 


20H = General controller failure 

40H = Seek operation failed 

80H = Time-out 

AAH = Drive not ready 

BBH = Undefined error occurred 
CCH = Write fault on selected drive 
EOH = Status error/error register is 0 
FFH = Sense operation failed 


40:75 Number of fixed disk drives attached 

40:76 Reserved 

40:77 Reserved 

Exceptions: 

40:74 Reserved (for devices using ESDI-type 
commands) 


40:76 Fixed disk drive control (for PC/XT) 


40:77 Fixed disk drive controller port (for PC/XT) 


Figure 3-12. Fixed Disk Drive Data Area 
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Address 
(Hex) Function 


40:78 Printer 1 time-out value 
40:79 Printer 2 time-out value 
40:7A Printer 3 time-out value 


40:7B Generic SCSI CBIOS and bus-master filter 
flags 
Bits 7, 6 Reserved 
Bit 5 Operating-system DMA services indicator 
= Q- Not supported; atl memory is 
mapped linear =physical 
= 1- Supported 
Reserved 
Interrupt-4BH-intercepted indicator 
= 0- Interrupt vector is not intercepted 
= 1- Interrupt vector is intercepted 
Reserved 
Generic SCSI CBIOS services support 
= 0- Interrupt 4BH does not support 
scsi 
= 1- Interrupt 4BH supports SCSI 
Bit 0 Reserved 


Exception: 

40:7B Printer 4 time-out value (for PC, PC/XT, AT, 
and Persona! System/2 Model 25 and Model 
30) 


Figure 3-13. Printer Time-Out Value Data Area 


Function 
RS-232C communication line 1 time-out value 
RS-232C communication line 2 time-out value 


RS-232C communication line 3 time-out value 


RS-232C communication line 4 time-out value 


Figure 3-14. RS-232C Time-Out Vaiue Data Area 
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Address 
(Hex) Function 


40:80 Keyboard buffer start offset pointer 


40:82 Keyboard buffer end offset pointer 


Figure 3-15. Keyboard Data Area 2 


Address 
(Hex) Function 


40:84 Number of rows on the screen (minus 1) 
40:85 Character height (bytes/character) 
40:87 Video control states 


40:88 Video control states 


40:89 Reserved 


40:8A Reserved 


Figure 3-16. Video-Contro/ Data Area 2 
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Address 
(Hex) 


40:8B 
Bits 7,6 


Bits 5, 4 


Function 


Media control 
Last diskette drive data rate selected 
(values in binary) 
= 00 - 500KB per second 
= 01 - 300KB per second 
= 10- 250KB per second 
= 11- 1MB per second 
Last diskette drive step rate selected 
= 00 - OCH 
= 01-0DH 
= 10-0EH 
= 11-0AH 
Reserved 
Reserved 
Reserved 
Reserved 


Fixed disk drive controller status 


Fixed disk drive controller error status 


Fixed disk drive interrupt control 


Reserved 


Figure 3-17 (Part 1 of 5). Diskette Drive/Fixed Disk Drive Control! Data 


Area 
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Address 
(Hex) Function 


40:90 Drive 0 media state 
Bits 7, 6 Data transfer rate (values in binary) 
= 00 - SOOKB per second 
01 - 300KB per second 
10 - 250KB per second 
11- 1MB per second 
Double stepping 
= 1- Double stepping required 
= 0- Double stepping not required 
Media/drive established 
= 1- Media/drive has been established 
= 0- Media/drive has not been established 
4MB media capability 
= 1- Drive is capable of supporting 4MB 
media 
= 0- Drive is not capable of supporting 
4MB media 
Bits 2 to 0 Drive/media state (values in binary) 
= 000 - 360KB diskette in 360KB drive is 
not established 
= 001 - 360KB diskette in 1.2MB drive is 
not established 
= 010 - 1.2MB diskette in 1.2MB drive is 
not established 
= 011 - 360KB diskette in 360KB drive is 
established 
= 100 - 360KB diskette in 1.2MB drive is 
established 
= 101 - 1.2MB diskette in 1.2MB drive is 
established 
110 - Reserved 
111 - None of the above 


Figure 3-17 (Part 2 of 5). Diskette Drive/Fixed Disk Drive Control Data 
Area 
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Address 
(Hex) Function 


40:91 Drive 1 media state 
Bits 7,6 Data transfer rate (values in binary) 
= 00 - SOOKB per second 
= 01 - 300KB per second 
= 10 - 250KB per second 
= 11- 1MB per second 
Double stepping 
= 1- Double stepping required 
= 0 - Double stepping not required 
Media/drive established 
= 1- Media/drive has been established 
= 0 - Media/drive has not been established 
4MB media capability 
= 1- Drive is capable of supporting 4MB 
media 
= 0- Drive is not capable of supporting 
4MB media 
Bits 2to0 Drive/media state (values in binary) 
= 000 - 360KB diskette in 360KB drive is 
not established 
= 001 - 360KB diskette in 1.2MB drive is 
not established 
= 010 - 1.2MB diskette in 1.2MB drive is 
not established 
= 011 - 360KB diskette in 360KB drive is 
established 
= 100 - 360KB diskette in 1.2MB drive is 
established 
= 101 - 1.2MB diskette in 1.2MB drive is 
established 
110 - Reserved 
111 - None of the above 


Figure 3-17 (Part 3 of 5). Diskette Drive/Fixed Disk Drive Control Data 
Area 
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Address 
(Hex) Function 


40:92 Drive 2 media state 
Bits 7, 6 Data transfer rate (values in binary) 
= 00 - S00KB per second 
= 01- 300KB per second 
10 - 250KB per second 
11- 1MB per second 
Double stepping 
= 1- Double stepping required 
= 0- Double stepping not required 
Media/drive established 
= 1- Media/drive has been established 
= 0- Media/drive has not been established 
4MB media capability 
= 1- Drive is capable of supporting 4MB 
media 
= 0 - Drive is not capable of supporting 
4MB media 
Multiple data rate capability determined 
= 1- Multiple data rate capability is 
determined 
= 0- Multiple data rate capability is not 
determined 
Multiple data rate capability 
= 1- Multiple data rate capability 
= 0- No multiple data rate capability 
80-track capability (drive 2) 
= 1- Drive 2, 80 tracks 
= 0 - Drive 2, 40 tracks 


Figure 3-17 (Part 4 of 5). Diskette Drive/Fixed Disk Drive Control Data 
Area 
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Address 
(Hex) Function 


40:93 Drive 3 media state 
Bits 7,6 Data transfer rate (values in binary) 

= 00 - SOOKB per second 

= 01- 300KB per second 

= 10 - 250KB per second 

= 11- 1MB per second 

Double stepping 

= 1- Double stepping required 

= 0- Double stepping not required 

Media/drive established 

= 1 - Media/drive has been established 

= 0- Media/drive has not been established 

4MB media capability 

= 1- Drive is capable of supporting 4MB 
media 

= 0- Drive is not capable of supporting 
4MB media 

Multiple data rate capability determined 

= 1- Multiple data rate capability is 
determined 

= 0- Multiple data rate capability is not 
determined 

Multiple data rate capability 

= 1- Multiple data rate capability 

= 0-No multiple data rate capability 

80-track capability (drive 3) 

= 1- Drive 3, 80 tracks 

= Q- Drive 3, 40 tracks 


40:94 Drive 0 current cylinder 


40:95 Drive 1 current cylinder 


Exception: 
40:8B to 40:95 Reserved (for PC, PC/r, PC/XT BIOS dated 
11/8/82, and PC Convertible) 


Figure 3-17 (Part 5 of 5). Diskette Drive/Fixed Disk Drive Control Data 
Area 
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Address 
(Hex) Function 


40:96 Keyboard mode state and type flags 
Bit 7 Read ID in progress 
Bit 6 Last character was first ID character 
Bit 5 Force num lock if read ID and KBX 
Bit 4 101/102-key keyboard installed 
Bit3 Right Alt key pressed 
Bit 2 Right Ctrl key pressed 


Bit 1 Last code was EO hidden code 
Bit 0 Last code was E1 hidden code 


40:97 Keyboard LED flags 
Bit 7 Keyboard transmit error flag 
Bit 6 Mode indicator update 
Bit § Resend receive flag 
Bit 4 Acknowledgment received 
Bit 3 Reserved (must be set to 0) 
Bits 2 to 0 Keyboard LED state bits 


Figure 3-18. Keyboard Data Area 3 


Address 
(Hex) Function 


40:98 Offset address to user wait complete flag 
40:94 Segment address to user wait complete flag 


40:9C User wait count - low word (in microseconds) 


40:9E User wait count - high word (in microseconds) 


40:A0 Wait active flag 
Bit 7 Wait time elapsed and Post 
Bits 6 to 1 Reserved 
Bit 0 Interrupt 15H, Wait function ((AH) = 86H) 
has occurred 


40:A1 to 40:A7 Reserved 


Figure 3-19. Real-Time Clock Data Area 
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For Personal System/2 products and systems with EGA capability, the 
save pointer table contains pointers that define specific dynamic 
overrides for Interrupt 10H, Set Mode function ((AH) =00H). 


Address 
(Hex) Function Size 


40:A8 Pointer to video parameters and overrides 
DWord 1 Video parameter table pointer 
initialized to the BIOS video parameter 
table; this value must contain a valid 
pointer. 
DWord 2 Dynamic save area pointer (for all systems 
except Personal System/2 Model 25 
and Model 30) 
Initialized to hex 00:00, this value is 
optional. When nonzero, this value 
points to an area in RAM where certain 
dynamic values are saved. This area 
holds the 16 EGA palette register 
values plus the overscan value in 
bytes (0 16), respectively. A 
minimum of 256 bytes must be 
allocated for this area. 
DWord 3 Alphanumeric mode auxiliary character 
generator 
Initialized to hex 00:00, this value is 
optional. When nonzero, this value 
Points to a table that is described as 


follows: 

Bytes/character Byte 
Block to be loaded Byte 

= 0- Normal operation 

Count to be stored Word 
= 256 - Normal operation 

Character offset Word 
= 0- Normal operation 

Pointer to a font table DWord 
Displayable rows Byte 


If OFFH, the maximum caiculated value 

is used. Otherwise, this value is used. 

Consecutive bytes of mode values for Byte 

this font description. The end of 

this stream is indicated by a byte 

code of OFFH. 
Note: Use of the DWord 3 pointer might cause unexpected cursor type operation. 
For an explanation of cursor type, see Interrupt 10H, Set Cursor Type 
function ((AH)} =O1H). 


Figure 3-20 (Part 1 of 2). Save Pointer Data Area 
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Address 
(Hex) Function 


DWord 4 Graphics mode auxiliary character 
generator pointer 
Initialized to hex 00:00, this value is 
optional. When nonzero, this value 
points to a table that is described as 
follows: 
Displayable rows 
Bytes per character 
Pointer to a font table 
Consecutive bytes of mode values for 
this font description. The end of 
this stream is indicated by a byte 
code of OFFH. 
DWord § Secondary save pointer (for all systems 
except EGA and Personai System/2 
Model 25 and Model 30) 
Initialized to the BIOS secondary save 
pointer; this value must contain a valid 
pointer. 
DWord 6 Reserved and set to hex 00:00 
DWord 7 Reserved and set to hex 00:00 


Figure 3-20 (Part 2 of 2). Save Pointer Data Area 
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Address 
(Hex) Function 


DWord 1 Table length 
initialized to the BIOS secondary save 
pointer table length 
DWord 2 Display combination code (DCC) table 
pointer 
Initialized to ROM DCC table. This value 
must exist. [It points to a table described 
as follows: 
Number of entries in table 
DCC table version number 
Maximum display type code 
Reserved 
00,00 - Entry 0 No displays 
00,01 - Entry 1 Monochrome display 
and printer adapter (MDPA) 
00,02 - Entry 2 Color/graphics monitor 
adapter (CGA) 
02,01 - Entry 3 MDPA + CGA 
00,04 - Entry 4 Enhanced graphics 
adapter (EGA) 
04,01 - Entry 5 EGA + MDPA 
00,05 - Entry 6 EGA with monochrome 
display (MEGA) 
02,05 - Entry 7 MEGA + CGA 
00,06 - Entry 8 Professional graphics 
controller (PGC) 
01,06 - Entry 9 PGC + MDPA 
05,06 - Entry 10 PGC + MEGA 
00,08 - Entry 11 Video graphics array 
(VGA) based with color display 
(CVGA) 
01,08 - Entry 12 CVGA + MDPA 
00,07 - Entry 13 VGA based with 
monochrome display (MVGA) 
02,07 - Entry 14 MVGA + CGA 
02,06 - Entry 15 MVGA + PGC 


Figure 3-21 (Part 1 of 2). Secondary Save Pointer Data Area 
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Address 
(Hex) Function Size 


DWord 3 Second alphanumeric mode auxiliary 
character generator pointer 
initialized to hex 00:00, this value is 
optional. When nonzero, this value 


points to a table that is described as 


follows: 
Bytes/character Byte 
Block to be loaded Byte 
= 0- Normal operation 
Reserved Byte 
Pointer to a font table DWord 
Consecutive bytes of mode values for Byte 


this font description. The end of 
this stream is indicated by a byte 
code of OFFH. 

Note: Attribute bit 3 is used to switch between primary and secondary fonts. It 
might be desirable to use the user palette profile to define a palette of 
consistent colors independent of attribute bit 3. 

DWord 4 User palette profile table pointer 
Initialized to hex 00:00, this value is 
optional. When nonzero, this value 
points to a table that is described as 


follows: 
Underlining flag Byte 
=1-On 
= 0- Ignore 
= —1- Off 
= 0- Normal operation 
Reserved Byte 
Reserved Word 
Internal patette count (0 to 17) Word 
= 17 - Norma! operation 
internal palette index (0 to 16) Word 
= 0- Normal operation 
Pointer to internal palette DWord 
External palette count (0 to 256) Word 
= 256 - Normal operation 
External palette index (0 to 255) Word 
= 0- Normal operation 
Pointer to external palette DWord 
Consecutive bytes of mode values for Byte 


this font description. The end of 
this stream is indicated by a byte 
code of OFFH. 

DWord 5 to Reserved (set to hex 00:00) 

DWord 7 


Figure 93-21 (Part 2 of 2). Secondary Save Pointer Data Area 
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Address 
(Hex) Function 


40:AC to 40:FF Reserved 


50:00 Print screen status (Interrupt 05H status) 


Figure 3-22. Miscellaneous Data Area 2 


Extended BIOS Data Areas 


The extended BIOS data area is supported on Personal System/2 
products only. POST allocates the highest possible nKB of memory 
below 640KB to be used as this data area. The word value at address 
hex 40:13 (memory size), which indicates the number of KB below the 
640KB limit, is decreased by n. The first byte in the extended BIOS 
data area is initialized to the length of the allocated area, in KB. 


To access the extended BIOS data area segment, call Interrupt 15H, 
Return Extended BIOS Data Area Segment Address function 

((AH) =C1H). To determine whether an extended BIOS data area is 
allocated, call Interrupt 15H, Return System Configuration 
Parameters function ((AH) = COH). 
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Section 4. ROM Tables 


The following ROM tables are used by BIOS to define the 
characteristics of the hardware devices that are supported by the 
system or adapter BIOS. 


Fixed Disk Drive Parameter Table 


The fixed disk drive parameter table is defined as follows: 


Length Description 


Word Maximum number of cylinders 
Byte Maximum number of heads 
Word For PC/XT: Starting reduced write current cylinder 
For all others: Not used 
Word Starting write precompensation cylinder 
Byte For PC/XT: Maximum ECC data-burst length 
For ali others: Not used 
Byte Control byte 
For PC/XT: 
Bit 7 - Disable disk-access retries 
Bit 6 - Disable ECC retries 
Bits 5t0 3 = 0 
Bits 2 to 0 - Drive option 
For all others: 
Bit 7 - Disable retries 
—or- 
Bit 6 - Disable retries 
Bit 5 - Manufacturer’s defect map present at 
maximum cylinders + 1 
Bit 3 - More than eight heads 
Bits 2 to 0 - Reserved 
For PC/XT: Standard time-out value 
For all others: Not used 
For PC/XT: Time-out value for format drive 
For all others: Not used 
For PC/XT: Time-out value for check drive 
For all others: Not used 
For PC/XT: Reserved 
For all others: Landing zone 
For PC/XT: Reserved 
For all others: Number of sectors per track 
Reserved 


Figure 4-1. Fixed Disk Drive Parameter Table 
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For AT and Personal System/2 products, the following table lists the 
fixed disk drive parameters for the various fixed disk drive types. 
Values are decimal unless noted otherwise. 


Number Number Number Number 
of of Write Landing Defect of 
Cylinders Heads Precompensation Zone Map Sectors 


= 
< 
vv 
® 


— No fixed disk drive installed — 
306 
615 
615 
940 
940 
615 
462 
733 
900 
820 
B55 
855 
306 
733 
— Reserved — 
612 


ah 


OFFFFH (None) 
256 

OFFFFH (None) 
OFFFFH (None) 
OFFFFH (None) 
OFFFFH (None) 
OFFFFH (None) 
128 

OFFFFH (None) 


OOMNOOAONM «a O 


EON CO 109 DO: OP 


0 (All cylinders) 
300 
OFFFFH (None) 
512 
300 
300 
300 
0 (All cylinders) 
305 
OFFFFH (None) 
OFFFFH (None) 
300 
488 
0 (All cylinders) 
306 
300 
OFFFFH (None) 
OFFFFH (None) 


1023 
614 


AANA RANAAARAUINANN OS 


Types 34-255 are reserved. 


Figure 4-2. Fixed Disk Drive Parameters (for AT and Personal System/2 
Products) 
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Notes: 


1. Software Interrupt 41H points to the entry in the table for drive 0. 
Software Interrupt 46H points to the entry in the table for drive 1. 


. AT BIOS dated 1/10/84 supports types 0 through 14. 
. AT BIOS dated 6/10/85 or 11/15/85 supports types 0 through 23. 
. PC/XT Model 286 supports types 0 through 24. 


Personal System/2 products except Model 25 and Model 30 
support types 0 through 32. 


oOo hw ND 


6. Personal System/2 Model 30 supports types 0 through 26. 


7. For Personal System/2 Model 70 and Model 80 BIOS dated 
10/7/87 and later and self-identifying drives, the fixed disk drive 
parameters in Figure 4-2 on page 4-2 and Figure 4-3 do not 
apply; software Interrupts 41H and 46H are reserved. 


8. To obtain the fixed disk drive parameters, use Interrupt 13H, 
Read Drive Parameters function ((AH) = 08H). 


For Personal System/2 products except Model 25 and Model 30, the 
following fixed disk drive parameters apply: 


Offset Length Description 


2 bytes Length of fixed disk drive table 
22 bytes ASCII string ‘IBM HARDFILE TYPE xxx’, where 
xxx is the type number, in ASCII 
1 byte Type number (in binary) 
2 bytes Maximum number of cylinders 
1 byte Maximum number of heads 
2 bytes Reserved 
2 bytes Start write precompensation cylinder 
1 byte Reserved 
1 byte Control byte 
Bit 7 or 6 - Disable retries 
Bit 5 - Defect map installed 
Bit 3 - More than eight heads (AT only) 
3 bytes Reserved 
2 bytes Landing zone 
1 byte Number of sectors per track 
1 byte Reserved 


Note: This information is located at head 0, track 0, sector 2; 
it applies only to ST412 and ST506 drive types. 


Figure 4-3. Fixed Disk Drive Parameters (for Personal System/2 Products 
except Model 25 and Model 30) 
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For PC/XT BIOS dated 11/10/82, the following fixed disk drive 
parameters apply: 


Description 


Maximum cylinders 

Maximum heads 

Start reduced write current cylinder 
Start write precompensation cylinder 


Maximum ECC burst data length 
Control byte 

Standard time-out 

Time-out for format drive 
Time-out for check drive 
Reserved 


Figure 4-4, Fixed Disk Drive Parameter Table 00 (for PC/XT BIOS Dated 
11/10/82) 


Size Value Description 


375 Maximum cylinders 

8 Maximum heads 

375 Start reduced write current cylinder 
0 Start write precompensation cylinder 


OBH Maximum ECC burst data length 
05H Control byte 

OCH Standard time-out 

0B4H Time-out for format drive 

028H Time-out for check drive 

0,0,0,0 Reserved 


Figure 4-5. Fixed Disk Drive Parameter Table 01 (for PC/XT BIOS Dated 
11/10/82) 
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Description 


Maximum cylinders 

Maximum heads 

Start reduced write current cylinder 
Start write precompensation cylinder 


Maximum ECC burst data length 
Control byte 

Standard time-out 

Time-out for format drive 
Time-out for check drive 
Reserved 


Figure 4-6. Fixed Disk Drive Parameter Table 02 (for PC/XT BIOS Dated 
11/10/82) 


Description 


Maximum cylinders 

Maximum heads 

Start reduced write current cylinder 
Start write precompensation cylinder 


Maximum ECC burst data length 
Control byte 
Standard time-out 
Time-out for format drive 
Time-out for check drive 

0,0,0,0 Reserved 


Figure 4-7. Fixed Disk Drive Parameter Table 03 (for PC/XT BIOS Dated 
11/10/82) 


Note: Software Interrupt 41H points to the beginning of the table. 


The switch settings on the adapter are used as an index into 
the table. 
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For PC/XT BIOS dated 1/8/86 and later, the following fixed disk drive 
parameters apply: 


Size Value Description 


DW 306 Maximum cylinders 
DB 4 Maximum heads 
DW 306 Start reduced write current cylinder 
0 Start write precompensation cylinder 
OBH Maximum ECC burst data length 
05H Control byte 
OCH Standard time-out 
OB4H Time-out for format drive 
028H Time-out for check drive 
0,0,0,0 Reserved 


Figure 4-8. Fixed Disk Drive Parameter Table 00 — Type 1 (for PC/XT BIOS 
Dated 1/8/86) 


Size Value Description 


Maximum cylinders 

Maximum heads 

Start reduced write current cylinder 
Start write precompensation cylinder 


Maximum ECC burst data length 
Control byte 

Standard time-out 

Time-out for format drive 
Time-out for check drive 
Reserved 


Figure 4-9. Fixed Disk Drive Parameter Table 01 — Type 16 (for PC/XT 
BIOS Dated 1/8/86) 
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Size 


Value Description 


DW 615 Maximum cylinders 

DB 4 Maximum heads 

DW 615 Start reduced write current cylinder 
DW 300 Start write precompensation cylinder 
DB OBH Maximum ECC burst data length 

DB 05H Control byte 

DB 18H Standard time-out 

DB 0B4H Time-out for format drive 

DB 028H Time-out for check drive 


0,0,0,0 Reserved 


Figure 4-10. Fixed Disk Drive Parameter Table 02 — Type 2 (for PC/XT 
BIOS Dated 1/8/86) 


Size Value Description 


DW 306 Maximum cylinders 

DB 8 Maximum heads 
306 Start reduced write current cylinder 
128 Start write precompensation cylinder 


OBH Maximum ECC burst data length 
05H Control byte 

OCH Standard time-out 

0B4H Time-out for format drive 

028H Time-out for check drive 

0,0,0,0 Reserved 


Figure 4-11. Fixed Disk Drive Parameter Table 03 — Type 13 (for PC/XT 
BIOS Dated 1/8/86) 


Note: Software Interrupt 41H points to the beginning of the table. 


The switch settings on the adapter are used as an index into 
the table. 
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Diskette Drive Parameter Table 


The diskette drive parameter table is defined as follows: 


Length Description 


Byte First specification byte 

Byte Second specification byte 

Byte Number of timer ticks to wait before turning the diskette 
drive motor off 

Byte Number of bytes per sector 
= 02H - 512 bytes per sector 

Byte Sectors per track 

Byte Gap length 

Byte Dti (data length) 

Byte Gap length for format 

Byte Fill byte for format 

Byte Head settle time (in milliseconds) 

Byte Motor startup time (in %e-second units) 
(For example, 8= 1-second wait) 


Figure 4-12. Diskette Drive Parameter Table 


Note: Software Interrupt 1EH points to the beginning of the diskette 
drive parameter table. 


If the caller changes the values of the head settle time (byte 9) and 
the motor startup time (byte 10) to values that are inconsistent with 
the diskette drive specifications, BIOS enforces the minimum values 
for these parameters as specified for the diskette drive. The values 
of these parameters can be increased to allow for correcting possible 
future problems if some diskette drives require more than the 
nominal values for these parameters. 
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Interrupt Sharing 


This section defines an interrupt-sharing protocol that enables 
multiple hardware adapters to share a single interrupt-request line. 


Considerations 


When implementing interrupt sharing, consider the following: 


The interrupt-sharing protocol is intended to run only in the real 
address mode. It is not intended to run in the protected (virtual 
address) mode. 


The interrupt-sharing protocol does not apply to the sharing of an 
interrupt level between an interrupt handler that is running in the 
real mode and an interrupt handler that is running in the 
protected mode. 


The interrupt-sharing protocol is not necessarily compatible with 
all operating systems. 


Interrupts must be disabled before control is passed to the next 
handler on the chain. Disabling of the interrupts enables the next 
handler to receive control as if a hardware interrupt had caused it 
to receive control. 


Interrupts must be disabled before the nonspecific End of 
Interrupt (EOI) instruction is issued. To ensure that the Return 
from Interrupt (IRET) instruction is executed, interrupts must not 
be reenabled in the interrupt handler. The flags are restored and 
the interrupts are reenabled before another interrupt is serviced, 
protecting the stack from excessive build-up. 


Each interrupt handler must have a routine that can be executed 
after power-on to disable its adapters’ interrupts. Executing this 
routine and resetting the interrupt-sharing hardware ensures that 
adapters are deactivated if the user resets the system. 


Interrupt-handier implementations must store data in memory 
using Intel data format; that is, word hex 424B is stored as 
4BH,42H in memory. 


** Intel is a trademark of Intel Corporation. 
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Interrupt Request (IRQ n) Reset 


The Micro Channel interrupt mechanism is level sensitive, whereas 
the PC-type I/O channel interrupt mechanism is edge sensitive. The 
level-sensitive Micro Channel mechanism simplifies the interrupt 
hardware that is needed for the adapters. 


An interrupt request in the PC-type i/O channel is implicitly reset 
because of the edge-sensitive characteristic of the signal. In the 
Micro Channel architecture, because of the level-sensitive 
characteristic of the signal, an interrupt request must be explicitly 
reset by the bus-slave interrupt-handler software. This is not the 
case when the bus-slave hardware implicitly resets the interrupt 
request. The system timer is an example of a bus-siave device that 
implicitly resets an interrupt. 


Interrupt-Sharing Software Requirements 


All interrupt-sharing software that is developed for Micro Channel bus 
slaves must reset the interrupt request. The interrupt-sharing 
chaining structure must be provided by all interrupt handlers. The 
16-byte interrupt-sharing chaining structure must begin at the third 
byte from the entry point of the interrupt handler. Pointers and flags 
that are stored in the interrupt-sharing chaining structure must be 
stored in Intel data format (see “Interrupt-Sharing Chaining Structure 
and Signature” on page 5-6). These requirements are specified to 
support the portability of interrupt handlers across hardware 
operating environments. 


The interrupt-handling software for all adapters that share an 
interrupt-request line must implement this interrupt-sharing software 
standard. Interrupt-sharing software that operates in a multitasking 
environment must support the linking of a task’s interrupt handler to a 
chain of interrupt handlers; the sharing of the interrupt level while 
that task is active; and the unlinking of the interrupt handler from the 
chain when the task is complete. 


To link an interrupt handler, the interrupt handler of a newly-activated 
task replaces the interrupt vector in low memory with a pointer to the 
interrupt handler. (See “ROM Considerations” on page 5-7 for 
information about interrupt handlers that are stored in ROM.) The 
interrupt handler must preserve the interrupt vector that it is 
replacing and use it as a forward pointer to the next interrupt handler 
in the chain. The old interrupt vector must be stored at a fixed offset 
from the entry point of the new task’s interrupt handler. 
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When the system acknowledges an interrupt request, each interrupt 
handler must determine whether it is the appropriate interrupt 
handler for the adapter that is presenting the interrupt request. To 
make this determination, the interrupt handler reads the contents of 
the interrupt-status register of the adapter. 


When an interrupt handler determines that its device caused the 
interrupt, the interrupt handler must service the interrupt, reset the 
interrupt-status bit, clear the interrupts, issue a nonspecific EO! 
instruction to the interrupt controller, then execute an IRET 
instruction. 


When an interrupt handler determines that its device did not cause 
the interrupt, the interrupt handler passes control to the next interrupt 
handler in the chain, using the previously-stored forward pointer. 


To unlink an interrupt handler from a chain, a task first locates the 
position of its interrupt handler in the chain. The task searches the 
chain, starting at the interrupt vector in low memory, and using the 
offset of each interrupt handler’s forward pointer to locate the entry 
point of each interrupt handler. The task repeats this process until it 
finds its own interrupt handler. The signature (hex 424B) of each 
interrupt handler must be checked to ensure that a valid forward 
pointer exists. The forward pointer of the task replaces the forward 
pointer of the previous interrupt handler in the chain, thus removing 
the interrupt handler from the chain. 


Note: If the interrupt handler cannot locate its position in the chain 
the interrupt handler cannot be unlinked. 


An application-dependent unlinking error-recovery procedure must 
be incorporated into the unlinking routine for situations in which the 
unlinking routine determines that the interrupt chain contains an 
interrupt handler that is linked but does not have a valid signature. 
To avoid this error condition, all interrupt-sharing handlers, except 
those in ROM (see “ROM Considerations” on page 5-7), must use 
hex 424B as their signature. 


In a system-reset condition, a routine for each interrupt handler must 
be executed after power-on to disable the interrupts from their 
devices. 


Operating-system environments that support dynamic relocation of 
software must manage the entire interrupt-sharing process. 
Interrupt-handler software that is written exclusively for 
dynamic-relocation operating-system environments does not have to 
provide an interrupt-sharing chaining structure. These interrupt 
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handlers do not have to provide Jinking and unlinking support, but 
they must provide support for disabling the interrupt capability of the 
bus slave that they support. 


Interrupt-Sharing Chaining Structure and Signature 


The interrupt-sharing software chaining structure has a 16-byte 
format that contains a 4-byte forward pointer (FPTR), a 2-byte 
signature, and 8 reserved bytes (RES_BYTES), as shown in the 
following example: 


ENTRY: JMP SHORT PAST ; Jump around structure 
FPTR DD 0 ; Forward pointer 
SIGNATURE DW 424BH ; Used when unlinking to identify 

; compatible interrupt handlers 

FLAGS DB io) ; Flags 
FIRST EQU 80H ; Flag for being first in chain 
JMP SHORT RESET 
RES_BYTES DB DUP 7(0) ; -Reserved- 

PAST: ... ; Actual start of code 


The interrupt-sharing software chaining structure begins at the third 
byte from the entry point of the interrupt handler. The first instruction 
of each interrupt handler is a short jump around the structure, placing 
the structure at a known offset from the beginning of the 
interrupt-handler routine. Because the position of the chaining 
structure of each interrupt handler is known (except for the interrupt 
handlers on adapter ROM), the forward pointers can be updated 
during linking and unlinking. 


The FIRST flag is used to determine the position of the interrupt 
handler in the chain during linking and unlinking for shared interrupt 
levels. The value of the FLAGS byte is changed to the value of the 
FIRST flag (hex 80) to indicate that the interrupt handler is the first 
interrupt handler that is linked in the chain. Each interrupt handler 
that is not stored in ROM must store the FIRST flag (hex 80) in the 
FLAGS byte when it is the first interrupt handler in the chain. 


The Reset routine, an entry point for the operating system, must 
disable the adapter interrupt and return to the operating system. 
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ROM Considerations 


An adapter with an interrupt handler in ROM must implement 
chaining by storing the forward pointer in a latch or in a port on the 
adapter. If the adapter is sharing interrupt level 7 or 15, it must also 
store the FIRST flag, which indicates whether it is positioned first in 
the chain of interrupt handlers. Storage of this information is 
required because it cannot be guaranteed that interrupt handlers in 
ROM will always link first and never unlink. The forward pointer in 
ROM interrupt handlers is not stored at the third byte from the entry 
point of the interrupt handler; therefore the ROM interrupt handler 
must contain the signature, 0000H, beginning at the seventh byte from 
the entry point of the interrupt handler. 


implementation Information 


The Interrupt Mask register is located at I/O port hex 21. Specific End 
of Interrupt (EOI) values for the various interrupt levels are listed (hex 
67 for level 7). To execute a specific EOI, issue an OUT instruction to 
the Programmable Interrupt Controller Operation Command register 
(port hex 20), using operation-command byte 2. To execute a 
nonspecific EOI, issue an OUT value of hex 20 to the Programmable 
Interrupt Controller Operation Command register (port hex 20). 


The following are examples of code that implements interrupt 
sharing: 


Linking 


PUSH ES 
CLI ;Clear interrupts 

;Set forward pointer to value of interrupt vector in low memory 
ASSUME CS: CODESEG, DS: CODESEG 


PUSH ES 
MOV AX, 350FH ;D0S get interrupt vector 
INT 21H 
MOV SI,OFFSET CS:FPTR ;Get offset of your forward pointer 
> in an indexable register 
MOV CS: [ST] ,BX ;Store the old interrupt vector 
MOV CS: [S1+2], ES ; in your forward pointer for 
; chaining 
CNP ES:BYTE PTR[BX],OCFH ;Test for IRET 
if iret_test_only_is_ needed ; See NOTE below 
JNE SETVECTR 
else 
JE FRSTVCTR 
CMP ES:WORD PTR[BX+6],424BH ; Is signature present? 
JE SETVECTR 
MOV AX,ES 
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CMP AX, QFQOQH sSee if pointing to dummy handler 
JNE SETVCTR 
CMP BX,WORD PTR ES:[OFFOQ1H] ; Dummy vector pointer? 
JNE SETVECTR sIf dummy, then first 
FRSTVCTR: 
endif 
MOV CS: FLAGS, FIRST ;Set up first in chain flag 
SETVECTR: POP ES 
PUSH DS 
;Make interrupt vector in low memory point to your handler 
MOV DX,OFFSET ENTRY  ;Make interrupt vector point to 
; your handler 
MOV AX,SEG ENTRY :If DS # CS, get it and 
MOV DS, AX 3 put it in DS 
MOV AX, 250FH ;DOS set interrupt vector 
INT 21H 
PoP DS 
;Unmask (enable) interrupts for your level 
IN AL, IMR sRead interrupt mask register 
JMP $+2 31/0 delay 
AND AL,O7FH ;Unmask interrupt level 7 
OUT IMR, AL sWrite new interrupt mask 
MOV AL,SPC_EOI ;Issue specific EOI for level 7 
JMP $+2 s to allow pending level 7 interrupts 
OUT OCR, AL 3 (if any) to be serviced 
STI sEnable interrupts 
POP ES 


Notes: 


1. The operating system must ensure that SEG:OFF points to a valid 
interrupt handler or to an IRET (hex OCF) for levels 7 and 15. 


2. Each ROM interrupt handler during ROMSCAN (before the 
operating system is loaded) and each interrupt handler on other 
than IRQ 7 must test SEG:OFF as shown in the “else” clause in 
this listing to determine whether it is the first interrupt handler in 
the chain. Checking SEG:OFF to determine whether it points to 
an IRET as the sole determination of FIRST is allowed only on 
IRQ 7, and then only after the operating system is loaded. 


Interrupt Handler 


YOUR_CARD EQU 
ISB EQU 
REARM EQU 
SPC_EOI EQU 
EOI EQU 
ocr EQU 


XXXX sLocation of your card interrupt 

; control/status register 
xX sInterrupt bit in your card 

; interrupt control/status register 
2F7H sGlobal Rearm location for 

; interrupt level 7 
67H sSpecific EOI for programmable 

; interrupt controller interrupt level 7 
20H sNonspecific EOI 
20H ;Location of programmable interrupt 


3 controller operation command register 
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IMR EQU 


MYCSEG SEGMENT 
ASSUME 
ENTRY PROC 
JMP 
FPTR DD 
SIGNATURE DW 


FLAGS DB 
FIRST EQU 
MP SHORT 
RES_BYTES DB 
PAST: ST1 
PUSH 
MOV 
IN 
TEST 
NZ 
TEST 
NZ 
POP 
cli 
MP 
SERVICE: 
EXIT: 


CLI 
MOV 
OUT 


MOV 
OUT 
POP 
IRET 
RESET: ae 
RET 
ENTRY ENDP 
MYCSEG ENDS 
END 


Unilnking 


PUSH 
PUSH 
CLI 
MOV 
INT 
MOV 


21H ;Location of programmable interrupt 
s controller interrupt mask 

PARA 

CS: MYCSEG, DS: DSEG 

FAR 

SHORT PAST ;Entry point of handler 

0 sForward pointer 

424BH ;Used when unlinking to identify 
; compatible interrupt handlers 

0 3Flags 

80H 

RESET 

7 DUP (0) ;Future expansion 
sActual start of handler code 

i ;Save needed registers 

DX, YOUR_CARD sSelect your status register 

AL,DX ;Read the status register 

AL, ISB sYour card caused interrupt? 

SERVICE 3Yes, branch to service logic 

CS: FLAGS ,FIRST sAre we the first ones in? 

EXIT 3If yes, branch for EOI and Rearm 

nex ;Restore registers 


;Clear interrupts 
DWORD PTR CS:FPTR ;Pass control to next handler on chain 
sService the interrupt 


;Clear interrupts 


AL, EOI 
OCR, AL sIssue nonspecific EOI to programmable 
3 interrupt controller 
DX, REARM ;Rearm the cards 
DX, AL 
re sRestore registers 
;Disable your card 
;Return FAR to operating system 
ENTRY 
DS 
ES 
;Clear interrupts 
AX, 350FH ;DOS get interrupt vector 
21H sES:BX points to first of chain 
CX,ES ;Pick up segment part of interrupt vector 


sAre we the first handler in the chain? 


MOV 
CMP 


JNE 
CMP 


INE 


AX,CS 3Get code seg into comparable register 
BX,OFFSET ENTRY ;Interrupt vector in low memory 
3; pointing to your handler offset? 


UNCHAIN_A sNo, branch 

AX, CX ;Vector pointing to your handler 
3 segment? 

UNCHAIN_A 3No, branch 
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sSet interrupt vector in low memory to point to the handler pointed to 
; by your pointer 


UNCHAIN_A: 


PUSH 
MOV 
MOV 
MOV 
INT 
POP 
JMP 
3; BX = 
CMP 


INE 
LDS 
CMP 


INE 
MOV 
CMP 


INE 


sLocate your handler 


UNCHAIN. B: 


UNCHAIN_X: 


MOV 
MOV 


MOV 
MOV 


MOV 
AND 
OR 
JMP 
MOV 
PUSH 
POP 
JMP 
STI 
POP 
POP 


os 

DX,WORD PTR CS:FPTR 

DS,WORD PTR CS:FPTR[2] 

AX, 250FH ;D0S set interrupt vector 

21H 

oS 

UNCHAIN_X 

FPTR offset, ES = FPTR segment, CX = CS 

ES: [BX+6],4B42H ;Is handler using the appropriate 
; conventions (is SIGNATURE present in 
; the interrupt chaining structure)? 

exception 3No, invoke error exception handler 

SI,ES: [BX+2] ;Get FPTR segment and offset 

SI,OFFSET ENTRY ;Is this forward pointer pointing to 
; your handler offset? 


UNCHAIN_B ;No, branch 

CX,DS ;Move to compare 

AX, CX sIs this forward pointer pointing to 
; your handler segment? 

UNCHAIN B 3No, branch 


in the chain 

AX,WORD PTR CS:FPTR ; Get your FPTR offset 

ES: [BX+2] , AX sReplace offset of FPTR of handler 
; that points to you 

AX,WORD PTR CS:FTPR[2] ; Get your FPTR segment 


ES: [BX+4] , AX ;Replace segment of FPTR of handler 
3 that points to you 

AL,CS: FLAGS 3Get your flags 

AL, FIRST sIsolate FIRST flag 

ES: [BX+6] ,AL 3Set your first flag into prior routine 

UNCHAIN_X 

BX,SI sMove new offset to BX 

DS 3Set pointer to next in chain 

ES 

UNCHAIN_A sExamine next handler in chain 
sEnable interrupts 

ES 

DS 
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Adapter ROM 


BIOS provides a method for integrating adapters with on-board ROM 
code into the system. During power-on self-test (POST), interrupt 
vectors are established for BIOS calls. When the default vectors are 
in place, a scan for adapter-ROM modules occurs. At this point, an 
adapter-ROM routine can gain control. The routine can establish or 
intercept interrupt vectors to hook into the system. 


Early in POST, the absolute addresses hex C0000 through hex C7FFF 
are scanned in 2KB blocks to search for adapter-ROM modules that 
need to be initialized (for example, valid video adapter ROM). 


Later in POST, the absolute addresses hex C8000 through hex DFFFF 
are scanned in 2KB blocks to search for devices with valid 
adapter-ROM modules. Valid adapter ROM is defined as follows: 


Byte 0: Hex 55 
Byte 1: Hex AA 


Byte 2: A length indicator, representing the number of 512-byte 
blocks (the limit is hex 7F) in the ROM (length divided by 
§12). A checksum tests the integrity of the ROM module. 
Each byte in the defined ROM is summed modulo hex 100. 
This sum must be 0 for the module to be valid. 


When POST identifies valid adapter ROM, it executes a far call to byte 
3 of the ROM (which should contain executable code). The device 
can now perform power-on initialization. The adapter ROM should 
return control to POST by executing a far return. 


For the PC Convertible, if the adapter ROM detects a self-test error, it 
should perform the following steps before returning: 


© Set bit 4 of hex 40:12 (POST status) to 1. 
© Set the device number for the supported adapter in (AH). 
e Set a two-digit error code in (AL). 


If no self-test error is found, the adapter ROM should reset bit 4 of hex 
40:12 (POST status) to 0 before returning. 


For Personal System/2 products with Micro Channel architecture, a 
video adapter in the channel has a ROM signature code that identifies 
it. During POST, when CMOS is not valid (abnormal condition), the 
signature code is used to find the first video adapter and set up its 
ROM programmable option select (POS) parameters. 
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The code starts at hex OC in the ROM address space and consists of: 


77H, CCH, ‘VIDEO ' 


The POS parameters are accessed from offset hex 30 in the ROM 
address space and are in the following order: 


POS Byte 102, POS Byte 103, POS Byte 104, POS Byte 105 


Video ROM scan remains from hex C0000 to hex C7FFF. 


For Personal System/2 BIOS dated 10/7/87 and later, the 
adapter-ROM integration method is as follows: 


Early in POST, the absolute addresses hex C0000 through DFFFF 
are scanned in 2KB blocks to search for adapter-ROM modules 
that have video-adapter signature code, as previously described. 
Only adapters with a video signature code are initialized early in 
POST. 


Later in POST, the absolute addresses hex C0000 through DFFFF 
are scanned in 2KB blocks to initialize other adapter-ROM 
modules that were not initialized in the early scan. 


For the PC Convertible, during early ROM scan, the following protocol 
is established to determine the video support: 


On return from a call to a video-adapter-ROM module, (BH) 
indicates the following: 


(BH) = OOH - Not a video adapter 

02H - Video adapter supporting video in the 
color/graphics adapter range 

= 04H - Video adapter supporting video in the 


monochrome adapter range 


5-12 Adapter ROM—September 1991 


Video-Function Compatibility 


The following procedures are recommended to provide video-function 
compatibility for application software. 


Video-Presence Test 


Use this video-presence test to determine which IBM video functions 
are present. 


1. Issue Interrupt 10H, Read/Write Display-Combination Code 
function with ((AH) = 1AH), Read Display-Combination Code 
((AL) = 00H). 


On return, if the value of (AL) is not hex 1A, the Read/Write 
Display-Combination Code function is not supported, and step 2 
should be followed to determine video presence. 


On return, if the vatue of (AL) is hex 1A, the information that is 
returned in (BX) defines the video environment. The active 
display code is returned in (BL). The alternative display code, if 
any, is returned in (BH). Refer to Interrupt 10H, Read/Write 
Display-Combination Code function ((AH) = 1AH) for display-code 
definitions. 


2. To determine the presence of an IBM Enhanced Graphics Adapter 
(EGA) when the Read/Write Display-Combination Code function is 
not supported, issue Interrupt 10H, Alternative Selection function 
((AH) = 12H), Return EGA Information ((BL) = 10H). 


On return, if the value of (BL) is hex 10, an EGA is not present, 
and step 3 should be followed. 


On return, if the value of (BL) is not hex 10, an EGA is present. 
Note that an IBM Color/Graphics Monitor Adapter or an IBM 
Monochrome Display and Printer Adapter might also be present, 
depending on the EGA switch settings. 


3. Complete steps 1 and 2 before performing this step. The video 
functions that might be present at this point are the IBM 
Color/Graphics Monitor Adapter, the IBM Monochrome Display 
and Printer Adapter, or both. Perform a presence test on video 
buffer addresses hex 0B8000 and hex 0B0000 to determine which 
video functions are present. 


Video-Function Compatibility—September 1991 5-13 


Video-Mode Switching 


Use the following video-mode switching procedure when applications 
will switch between monochrome and color video modes. A correct 
video-presence test, as previously described, is required. The 
following three system-video environments are possible: 


1. A single video function that supports either monochrome or color 
video modes. If a monochrome function is present, only 
monochrome video modes are available. If a color function is 
present, only color video modes are available. 


2. Two video functions, one supporting color video modes, and the 
other supporting monochrome video modes. In this case, both 
monochrome and color video modes are available. To switch 
from monochrome to color or from color to monochrome, the 
application program must change bits 5 and 4 (video mode type) 
of data area hex 40:10 to monochrome or color and issue 
Interrupt 10H, Set Mode function ((AH) = 00H). 


3. A single video function that supports both monochrome and color 
video modes. To determine whether a single video function 
supports both monochrome and color video modes, the 
application program should issue Interrupt 10H, Return 
Functionality/State Information function ((AH) = 1BH). 


On return, if the value of (AL) is not hex 1B, the Return 
Functionality/State Information function is not supported, and 
support for both monochrome and color video modes on a single 
video function is not available. 


On return, if the value of (AL) is hex 1BH, use the returned 
information to determine whether bit 0 (all modes on all displays 
active) of byte (DI+ 2DH) is set to 1. If it is set to 1, both 
monochrome and color modes are available, and the application 
program should change the video-modes bits for monochrome or 
color and issue Interrupt 10H, Set Mode function ((AH) = 00H). If it 
is set to 0, only monochrome modes or color modes are 
available, depending on the results of the video-presence test. 
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Multitasking Provisions 


BIOS provides hooks to assist in multitasking information. Whenever 
a Busy (Wait) loop occurs in BIOS, a hook is provided for the program 
to break out of the loop. Also, when BIOS services an interrupt, a 
corresponding Wait loop is ended, and another hook is provided. A 
program can be written that employs most of the device-driver code. 
The following information is valid only in the microprocessor 
real-address mode, and the code must use the following procedures 
to enable this support. 


The program is responsible for matching corresponding Wait and 
Post calls and for the serialization of access to the device driver. The 
BIOS code is not reentrant. 


The multitasking dispatcher uses the following four interfaces: 


Startup: The startup code hooks Interrupt 15H. The dispatcher is 
responsible for checking for function codes (AH) =90H and (AH) =91H 
(see the following descriptions of Wait and Post). The dispatcher 
must pass all other functions to the previous user of Interrupt 15H 
(use a JMP or CALL instruction). If the value of (AH) is hex 90 or hex 
91, the dispatcher must perform the appropriate processing and 
return by the IRET instruction. 


Serialization: The multitasking system must ensure that the device 
driver code is used serially. Multiple entries into the code can result 
in errors. 


Wait (Busy): When BIOS is about to enter a Wait loop, it first issues 
Interrupt 15H, (AH)=90H. This signals a Wait condition. At this point, 
the dispatcher should save the task status and dispatch another task. 
This enables overlapped execution of tasks when the hardware is 
busy. The following is an outline of the code that has been added to 
BIOS to perform this function. 


MOV AX, 90xxH sWait code in AH and 
s type code in AL 

INT 15H ;Issue call 

JC TIMEOUT ;Optional: for time-out or 
; if carry is set, time-out 
s occurred 


NORMAL TIMEOUT LOGIC ;Normal time-out 
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Post (Interrupt): When BIOS has set an interrupt flag for a 
corresponding Busy loop, it issues Interrupt 15H, (AH) =91H. This 
signals a Post condition. At this point, the dispatcher must set the 
task status to “ready to run” and return to the interrupt routine. The 
following is an outline of the code that has been added to BIOS to 
perform this function. 


MOV AX, 91xxH :Post code AH and 
; type code AL 
INT 15H :Issue call 


Three Wait loop function-code classes are supported: 


* The first (hex 0 to hex 7F) is serially reusable. This means that 
for devices that use these codes, access to BIOS must be 
restricted to one task at a time, and the operating system must 
serialize access. 


¢ The second (hex 80 to hex BF) is for reentrant devices. There is 
no restriction on the number of tasks that can use a device. 
(ES:BX) is used to distinguish between different calls. 


* The third (hex CO to hex FF) is noninterrupt (wait-only calls). 
There is no corresponding interrupt for the Wait loop. The 
dispatcher must take the appropriate action to satisfy this 
condition and exit from the loop. There is no complementary 
Post for these Wait conditions. They are time-out only, and the 
times are function-number dependent. 


To support time-outs properly, the multitasking dispatcher must be 
aware of time. If a device enters a Busy loop, generally, it should 
remain there for a specific length of time before indicating an error. 
The dispatcher must return to the BIOS Wait loop with the carry flag 
set to 1 if a time-out occurs. 
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Application Guidelines 


Use the following information to develop application programs for 
IBM Personal System/2 and Personal Computer products. Whenever 
possible, BIOS should be used as an interface to hardware to provide 
maximum compatibility and portability of applications across 
systems. 


Math-Coprocessor Testing 


Interrupt 11H (Equipment Determination) should be used where 
possible as the method for detecting the presence of the math 
coprocessor. 


Hardware Interrupts 


Hardware interrupts are level sensitive for systems that use the Micro 
Channel architecture; hardware interrupts are edge triggered for 
systems that use the PC-type I/O channel. In edge-triggered-interrupt 
systems, the interrupt controller clears its internal ‘interrupt in 
progress’ latch when the interrupt routine sends an End of Interrupt 
(EOI) command to the controller. The EOI command is sent, 
regardless of whether the incoming interrupt request to the controller 
is active or inactive. 


In level-sensitive-interrupt systems, the ‘interrupt in progress’ latch is 
readable at an /O-address bit position. This latch is read during the 
Interrupt Service routine; it can be reset by the read operation, or it 
might require an explicit reset. 


Note: For performance and latency considerations, designers might 
want to limit the number of devices that share an interrupt 
level. 


The interrupt controller on level-sensitive interrupt systems requires 
the interrupt request to be inactive at the time the EOI command is 
sent; otherwise, a “new” interrupt request will be detected, and 
another microprocessor interrupt will be caused. 


| To avoid this problem, a level-sensitive interrupt handler must clear 
| the interrupt condition, usually by a Read or Write command to an I/O 
| port on the device that is causing the interrupt. 


| Because of the speed of the processor, a delay must be added after 
| every repetitive I/O operation to a controller or device to ensure that 
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| /O operations are synchronized with the processor. The JMP $+2 
| instruction is not recommended for this purpose. 


| Before the interrupt controllers are programmed, interrupts should be 
| disabled through a Clear Interrupt Flag (CLI) instruction. This 

| includes programming of the Mask register and issuing EOI 

| instructions, initialization-command bytes, and operation-command 

| bytes. 


In level-sensitive-interrupt systems, hardware prevents the interrupt 
controllers from being set to the edge-triggered mode. 


Hardware interrupt IRQ 9 is defined as the replacement interrupt 
level for the cascade level IRQ 2. Program interrupt sharing should 
be implemented on IRQ 2, Interrupt OAH. The following processing 
occurs to maintain compatibility with the IRQ 2 that is used by IBM 
Personal Computer products: 


1. A device drives the interrupt request that is active on IRQ 2 of the 
channel. 


2. This interrupt request is mapped in hardware to IRQ 9 input on 
the slave interrupt controller. 


3. When the interrupt occurs, the system microprocessor passes 
contro! to the IRQ 9 (Interrupt 71H) interrupt handler. 


4. This interrupt handler sends an EOI command to the slave 
interrupt controller and passes control to the IRQ 2 (Interrupt 
OAH) interrupt handler. 


5. When handling the interrupt, the IRQ 2 interrupt handler causes 
the device to reset the interrupt request before sending an EOI 
command to the master interrupt controiler that finishes servicing 
the IRQ 2 request. 


Programming Considerations 


The IBM-supported languages of IBM C, BASIC, FORTRAN, COBOL, 
and Pascal are the best choices for writing compatible programs. Ifa 
program uses specific features of the hardware, the program might 
not be compatible with all IBM Personal System/2 and Personal 
Computer products. 


Any program that requires precise timing information should obtain it 


through an operating system or language interface (for example, 
TIME$ in BASIC). The use of programming loops can prevent a 
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program from being compatible with other Personal System/2 and 
IBM Personal Computer products and software. 


BIOS and Operating-System Function Calls 


For maximum portability, programs should perform all I/O operations 
through operating-system function calls. In environments where the 
operating system does not provide the necessary programming 
interfaces, programs should access the hardware through BIOS 
function calls, if it is permissible. When writing programs, consider 
the following: 


* In some environments, program interrupts are used for access to 
these functions. This practice removes the absolute addressing 
from the program. Only the interrupt number is required. 


« The system can mask hardware sensitivity. New devices can 
change BIOS to accept the same programming interface on the 
new device. 


« When BIOS provides parameter tables, such as for video or 
diskette, a program can substitute new parameter values by 
building a new copy of the table and changing the vector to point 
to that table. The program should copy the current table, using 
the current vector, and then modify those locations in the table 
that need to be changed. In this way, the program does not 
inadvertently change any values that should be left the same. 


* The diskette parameters table that is pointed to by Interrupt 1EH 
consists of 11 parameters that are required for diskette operation. 
It is recommended that the values that are supplied in ROM be 
used. If it becomes necessary to modify any of the parameters, 
build another parameter block, and modify the address at 
Interrupt 1EH (hex 00:78) to point to the new block. 


The parameters were established to allow: 


— Some models of the IBM Personal Computer to operate both 
the 5.25-inch high-capacity diskette drive (96 tracks per inch) 
and the 5.25-inch double-sided diskette drive (48 tracks per 
inch) 


~ Some models of the Personal System/2 system to operate 
both the 3.5-inch 1.44MB diskette drive and the 3.5-inch 
720KB diskette drive. 


The Gap Length parameter is not always retrieved from the 
parameter block. The gap length that is used during diskette 
read, write, and verify operations is derived from within diskette 


Application Guidelines—September 1991 5-19 


BIOS. The gap length for format operations is still obtained from 
the parameter block. 


If a parameter block contains a Head Settle Time parameter 
value of 0 milliseconds, BIOS enforces a minimum head settle 
time of 15 milliseconds. Read and verify operations use the head 
settle time that is provided by the parameter block. 


For any function that requires a parameter block that contains a 
Motor Start Wait parameter of less than 500 milliseconds (1 
second for a Personal Computer product), diskette BIOS enforces 
a minimum time of 500 milliseconds (1 second for a Personal 
Computer product). 


¢ Programs can be designed to reside on both 5.25-inch and 
3.5-inch diskettes. Because not all programs are 
operating-system dependent, the following procedure can be 
used to determine which type of media is in a diskette drive: 


1. Verify track 0, head 0, sector 1 (1 sector). This enables 
diskette BIOS to determine whether the format of the media is 
a recognizable type. 


If the verify operation fails, issue the Reset function 
((AH) =00H) to diskette BIOS and try the operation again. If it 
faits again, the media needs to be formatted or is defective. 


2. Verify track 0, head 0, sector 16 (1 sector). 


If the verify operation fails, either a 5.25-inch (48 TPl) ora 
3.5-inch 720KB diskette is installed. To determine the type, 
verify track 78, head 1, sector 1 (1 sector). A successful 
verification of track 78 indicates that a 3.5-inch 720KB diskette 
is installed: a failed verification indicates that a 5.25-inch (48 
TPI) diskette is installed. 


Note: Refer to the DOS Technical Reference for the 
file-allocation-table parameters for single-sided and 
double-sided diskettes. 


3. Read the diskette-controller status in BIOS, starting with 
address hex 40:42. The fifth byte defines the head that the 
operation ended with. If the operation ended with head 1, the 
diskette is a 5.25-inch high-capacity (96 TPI) diskette; if the 
operation ended with head 0, the diskette is a 3.5-inch 1.44MB 
diskette. 


4. Newer Personal System/2 products might support 
Interrupt 13H—Diskette, Get Media Type function ((AH) = 20H). 
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Section 6. System Identification 


Each BIOS ROM module has a mode! byte at address hex F000:FFFE 
in ROM. In some cases, a submodel byte and a BIOS revision-level 
byte are used to further distinguish between the various BIOS ROM 
modules. To gain access to this information, see Interrupt 15H, 
Return System Configuration Parameters function ((AH) = COH). 


A model byte changes when there are major processing-unit 
architecture changes. For example, 80286-based systems have 
model byte hex FC and have the following additional features: 


® Protected virtual address mode 
e 24 bits of addressing. 


The 80386- and 80486-based systems have model byte hex F8 and 
have the following additional features: 


¢ 32-bit registers 
© 32-bit addressing 
© 32-bit flat model mode 
¢ Virtual 8086 mode. 
A submodel byte changes when a system implements a 


software-detectable change from previous systems with the same 
model byte. 


A BIOS revision level changes when the ROM image changes for a 
model or submodel. 


The following table lists the system-identification information for 
Personal Computer and Personal System/2 products. 


BIOS Submodel 
Date Byte Revision 


4/24/81 
10/19/81 
10/27/82 
11/8/82 
1/10/86 
5/9/86 
6/1/83 


Figure 6-1 (Part 1 of 3). System Identification 
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BIOS Submodel 
Date Byte Revision 


1/10/84 

6/10/85 

11/15/85 
PC/XT Model 286 4/21/86 
PC Convertible 9/13/85 
PS/2 Model 25 6/26/87 
PS/2 Model 25 11/2/88 
PS/2 Model 30 9/2/86 
PS/2 Model 30 1/31/89 
PS/2 Model 30 286 8/25/88 
PS/2 Model 30 286 11/30/88 
PS/2 Model 30 286 5/30/89 
PS/2 Model 30 286 
PS/2 Model 40 SX/35 SX 3/15/91 
PS/2 Model 40 SX/35 SX 4/4/91 
PS/2 Model 40 SX/35 SX 6/4/91 
PS/2 Model L40 SX 
PS/2 Model 50 (Type 1) 2/13/87 
PS/2 Model 50 
PS/2 Model 50 (Type 1) 11/2/89 
PS/2 Model 50 (Type 2) 1/28/88 
PS/2 Model 50 §/12/88 
PS/2 Model 55 SX 11/2/88 
PS/2 Model 55 SX 
PS/2 Model 55 LS 2/8/90 
PS/2 Model! 57 SX 5/10/91 
PS/2 Model 60 2/13/87 
PS/2 Model 65 SX 2/8/90 
PS/2 Model 70 (Type 2) 4/11/88 
PS/2 Model 70 3/17/89 
PS/2 Model 70 12/15/89 
PS/2 Model 70 (Type 1) 4/11/88 
PS/2 Model 70 3/17/89 
PS/2 Model 70 12/15/89 
PS/2 Model 70 (Type 3) 6/8/88 
PS/2 Mode! 70 2/20/88 
PS/2 Model 70 486 (Type 4) 12/1/89 
PS/2 Mode! P70 
PS/2 Model P70 
PS/2 Model 80 (Type 14) 3/30/87 
PS/2 Model 80 
PS/2 Model 80 6/19/89 
PS/2 Model 80 (Type 2) 10/7/87 
PS/2 Model 80 11/21/89 
PS/2 Model 80 2/15/90 


Figure 6-1 (Part 2 of 3). System Identification 
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BIOS Submodel 
Product Date Revision 


PS/2 Model 90 (Type 1) 10/1/90 00 
PS/2 Model 90 (Type 2) 10/1/90 
PS/2 Model 90 (Type 3) 4/24/91 
PS/2 Model 90 (Type 3) 4/24/91 
PS/2 Model 95 (Type 1) 10/1/80 
PS/2 Model 95 (Type 2) 10/1/90 
PS/2 Model 95 (Type 3) 4/24/91 
PS/2 Model 95 (Type 3) 4/24/91 


Figure 6-1 (Part 3 of 3). System Identification 


Note: Information about a specific system board can be found in the 
technical reference for that model. 


System Identification—September 1991 6-3 


Notes: 
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Section 7. Scan Code/Character Code 
Combinations 


Note: For scan code/character code combinations for the PC Space 
Saving (84-/85-key) Keyboard, refer to the Personal System/2 
| Model 25 Technical Reference or the “Keyboards” section of 
| the Personal System/2 Hardware Interface Technical 
| Reference—Common Interfaces. 


| The Keyboard Read function ((AH) = 00H) and the Keyboard Status 

| function ((AH) =01H) of Interrupt 16H apply to the 83-/84-key 

| keyboard, the 101-/102-key keyboard (standard and extended 

| function), and the 122-key keyboard. However, these functions return 
| only the scan code/character code combinations that are supported 

| by the 83-/84-key keyboard and the 101-/102-key standard-function 

| keyboard. 


| The Extended-Keyboard Read function ((AH) = 10H) and the Extended 
| Keystroke Status function ((AH)= 11H) apply to the 83-/84-key 

| keyboard, the 101-/102-key keyboard (standard and extended 

| function), and the 122-key keyboard. However, these functions return 
| only the scan code/character code combinations that are supported 

| by the 101-/102-key extended-function keyboard. 


| The Keyboard Read for the 122-Key Keyboard function ((AH) = 20H) 

| and the Keystroke Status for the 122-Key Keyboard function 

| ((AH) =21H) apply to the 83-/84-key keyboard, the 101-/102-key 

| keyboard (standard and extended function), and the 122-key 

| keyboard. See the table on page 7-13 for the additional keystrokes 

| and scan code/character code combinations that are supported by the 
| 122-key keyboard. 
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The following table lists the keyboard keystrokes and the scan 


code/character code combinations that are returned through Interrupt 
16H. 


83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Esc 01/1B 01/1B 01/1B 
1 02/31 02/31 02/31 
03/32 03/32 
04/33 04/33 
05/34 05/34 
06/35 06/35 
07/36 07/36 
08/37 08/37 
09/38 09/38 
0A/39 0A/39 
0B/30 0B/30 
0c/2D 0c/2D 
0D/3D 0D/3D 
Backspace 0E/08 0E/08 
Tab OF/09 OF/09 
10/71 10/71 
11/77 11/77 
12/65 12/65 
13/72 13/72 
14/74 14/74 
15/79 15/79 
16/75 16/75 
17/69 17/69 
18/6F 
19/70 
1A/5B 
1B/5D 
1C/0D 


'oOowoOna na dn 


q 
w 
e 
r 
t 
y 
u 
i 
° 
p 
[ 
] 


1E/61 
1F/73 
20/64 
21/66 


Figure 7-1 (Part 1 of 3). Keyboard Keystrokes 
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83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


22/67 22/67 22/67 
23/68 23/68 23/68 
24/6A 24/6A 24/64 
25/6B 25/6B 25/6B 
26/6C 26/6C 26/6C 
27/3B 27/3B 27/3B 
28/27 28/27 28/27 
29/60 29/60 


(_—*=~— 370 


ee see 
=. 
= 


2B/5C 28/5C 
2C/7A 2C/7A 
20/78 20/78 
2E/63 2E/63 
2F/76 2F/76 
30/62 30/62 
31/6E 31/6E 
32/6D 32/6D 
33/2C 33/2C 
34/2E 34/2E 
35/2F 35/2F 
37/2A 37/2A 


\ 
z 
x 
c 
v 
b 
n 
m 


Alt 

Space 39/20 39/20 

Caps Lock a ne 
3B/00 3B/00 
3C/00 30/00 
3D/00 3D/00 
3E/00 3E/00 
3F/00 3F/00 
40/00 40/00 
41/00 41/00 
42/00 42/00 
43/00 43/00 


Figure 7-1 (Part 2 of 3). Keyboard Keystrokes 
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83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


F10 44/00 44/00 44/00 
F11 (no key) - 85/00 


F12 (no key} - 86/00 
Num Lock ay fe i 
Scroll Lock a ve is 
Home 47/00 47/00 47/00 
Up Arrow 48/00 48/00 48/00 
PgUp 49/00 49/00 49/00 
- 4A/2D 4A/2D 4A/2D 
Left Arrow 4B/00 4B/00 4B/00 
Center Key ~ “- 4C/00 
Right Arrow 40/00 40/00 4D/00 
+ 4E/2B 4E/2B 4E/2B 
End 4F/00 4F/00 4F/00 
Down Arrow 50/00 50/00 50/00 
PgDn 51/00 51/00 51/00 
Ins 52/00 52/00 §2/00 
Del 53/00 53/00 53/00 
SysRq a (no key) (no key) 
Key 45 (no key) 56/5C 56/5C 
Enter (no key) 10/0D E0/0D 
/ (no key) 35/2F E0/2F 
PrtSc (no key) a oe 
Pause (no key) A i 
Home (no key) 47/00 47/E0 
Up Arrow (no key) 48/00 48/E0 
PageUp (no key) 49/00 49/E0 
Left Arrow (no key) 4B/00 4B/E0 
Right Arrow (no key) 4D/00 4D/EO 
End (no key) 4F/00 4F/E0 
Down Arrow (no key) 50/00 50/E0 
PageDown (no key) 51/00 51/E0 
Insert (no key) 52/00 52/E0 
Delete (no key) 53/00 53/00 


** These combinations do not provide a keystroke for the application that is 
currently running, but they perform some other action. They are not put 
into the Interrupt 16H queue. 

-- These combinations have no function and are ignored. 


Figure 7-1 (Part 3 of 3). Keyboard Keystrokes 
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The following table lists the Shift keyboard keystrokes and the scan 
code/character code combinations that are returned through Interrupt 
16H. 


83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Shift Esc 01/1B 01/1B 01/1B 
Shift ! 02/21 02/21 02/21 
Shift @ 03/40 03/40 03/40 
Shift # 04/23 04/23 
Shift $ 05/24 05/24 
Shift % 06/25 06/25 
Shift a 07/5E 07/5E 
Shift & 08/26 08/26 
Shift * 09/2A 09/2A 
Shift ( OA/28 0A/28 
Shift ) 0B/29 0B/29 
Shift _ OC/SF OC/SF 
Shift + 0D/2B 0D/2B 
Shift Backspace OE/08 0E/08 
Shift Tab (Backtab) OF/00 OF/00 
Shift Q 10/51 10/51 
Shift W 11/57 11/57 
Shift E 12/45 12/45 
Shift R 13/52 13/52 
Shift T 14/54 14/54 
Shift Y 15/59 15/59 
Shift U 16/55 16/55 
Shift | 17/49 17/49 
Shift O 18/4F 18/4F 
Shift P 19/50 19/50 
Shift { 1A/7B 1A/7B 
Shift } 1B/70 1B/7D 
Shift Return 1C/0D 1C/0D 
Shift Ctrl is bie; 
Shift A 1E/41 1E/41 
Shift S 1F/53 1F/53 
Shift D 20/44 20/44 
Shift F 21/46 21/46 
Shift G 22/47 22/47 
Shift H 23/48 23/48 
Shift J 24/4A 24/44 
Shift K 25/4B 25/4B 
Shift L 26/46 26/4C 
Shift : 27/3A 27/3A 
Shift " 28/22 28/22 
Shift ~ 29/7E 29/7E 


Figure 7-2 (Part 1 of 3). Shift Keyboard Keystrokes 


Scan Code/Character Code Combinations—September 1991 7-5 


83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Shift | 2B/7C 2B/7C 2B/7C 
Shift Z 2C/5A 2C/5A 2C/5A 
Shift X 2D/58 2D/58 2D/58 
Shift C 2E/43 2E/43 2E/43 
Shift V 2F/56 2F/56 2F/56 
Shift B 30/42 30/42 30/42 
Shift N 31/4E 31/4E 31/4E 
Shift M 32/4D 32/4D 32/4D 
Shift < 33/3C 33/3C 33/3C 
Shift > 34/3E 34/3E 
Shift ? 35/3F 35/3F 
Shift * 37/2A 37/2A 
Shift Alt ae a8 
Shift Space 39/20 39/20 
Shift Caps Lock ae = 
Shift F1 54/00 54/00 
Shift F2 55/00 55/00 
Shift F3 56/00 56/00 
Shift F4 57/00 57/00 
Shift F5 58/00 §8/00 
Shift F6 59/00 59/00 
Shift F7 5A/00 5A/00 
Shift F8 5B/00 

Shift F9 5C/00 

Shift F10 5D/00 

Shift F11 (no key) 

Shift F12 

Shift Num Lock 

Shift Scrol! Lock 

Shift 7 

Shift 8 

Shift 9 

Shift - 

Shift 4 

Shift 5 

Shift 6 

Shift + 

Shift 1 

Shift 2 

Shift 3 

Shift 0 

Shift . 

Shift SysRq (no key) 

Shift Key 45 (no key) 56/7C 

Shift Enter (no key) 1C/0D 

Shift / (no key) 35/2F 


Figure 7-2 (Part 2 of 3). Shift Keyboard Keystrokes 
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83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Shift PrtSc (no key) ne is 

Shift Pause (no key) Ma as 

Shift Home (no key) 47/00 47/E0 
Shift Up Arrow (no key) 48/00 48/E0 
Shift PgUp (no key) 49/00 49/E0 
Shift Left Arrow {no key) 4B/00 4B/E0 
Shift Right (no key) 4D/00 4D/Eo 


Shift End (no key) 4F/00 4F/E0 
Shift Down Arrow (no key) 50/00 50/E0 
Shift PgDn (no key) 51/00 51/E0 
Shift Insert (no key) 52/00 52/E0 
Shift Delete {no key) §3/00 53/E0 


““ These combinations do not provide a keystroke for the application that is 
currently running, but they perform some other action. They are not put 
into the Interrupt 16H queue. 

-- These combinations have no function and are ignored. 


Figure 7-2 (Part 3 of 3). Shift Keyboard Keystrokes 


The following table lists the Ctr! keyboard keystrokes and the scan 
code/character code combinations that are returned through Interrupt 
16H. 


83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Ctrl Esc 01/1B O1/1B 01/1B 
Ctri1 - -- - 
Ctrl 2 (NUL) 03/00 03/00 03/00 
Ctrl 3 

Ctri 4 

Ctrl 5 

Ctri 6 (RS) 

Ctrl 7 

Ctrl 8 

Ctrl 9 

Ctrl 0 

Ctrl _ OC/1F 

Ctrl = ~- 

Ctrl Backspace (DEL) OE/7F 

Ctrl Tab - 


Figure 7-3 (Part 1 of 3). Ctrl Keyboard Keystrokes 
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83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Ctrl gq (DC1) 10/11 10/11 10/11 
Ctrl w (ETB) W/N7 VAIN7 11/17 
Ctrl e (ENQ) 12/05 12/05 12/05 
Ctri r (DC2) 13/12 13/12 13/12 
Ctri t (C4) 14/14 14/14 14/14 
Ctrl y (EM) 15/19 15/19 15/19 
Ctrl u (NAK) 16/15 16/15 16/15 
Ctri i (HT) 17/09 17/08 17/09 
Ctrl o (SI) 18/0F 18/0F 18/0F 
Ctrl p (DLE) 19/10 19/10 19/10 
Ctr! [ (ESC) 1A/1B 1A/1B 1A/1B 
Ctrl ] (GS) 1B/1D 1B/1D 1B/1D 
Ctrt Return (LF) iC/0A 1C/0A 1C/0A 
Ctri a (SOH) 1E/01 1E/01 1E/01 
Ctrt s (DC3) TF/I3 1F/13 1F/13 
Ctrl d (EOT) 20/04 20/04 20/04 
Ctrl f (ACK) 21/06 21/06 21/06 
Ctrl g (BEL) 22/07 22/07 
Ctrl h (Backspace) 23/08 23/08 
Ctrl j (LF) 24/0A 24/0A 
Ctrl k (VT) 25/0B 25/0B 


Ctrl | (FF) 26/0C 26/0C 
Ctrl; 
Ctrl’ 
Ctrl ‘ 


Ctrl Shift 
Ctrl \ (FS) 
Ctrl z (SUB) 
Ctr! x (CAN) 
Ctrl c (ETX) 
Ctrl v (SYN) 
Ctrl b (STX) 
Ctrl n (SO) 
Ctrl m (CR) 
Ctr, 

Ctrl. 

Ctri/ 

Ctrl * 

Ctrl Alt 

Ctrl Space 
Ctrl Caps Lock 
Ctrl F1 

Ctrl F2 

Ctrl F3 

Ctrl F4 

Ctrl F5 


Figure 7-3 (Part 2 of 3). Ctri Keyboard Keystrokes 
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83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Ctrl Fé 63/00 63/00 63/00 
Ctrl F7 64/00 64/00 64/00 
Ctrl F8 65/00 65/00 65/00 
Ctrl F9 66/00 66/00 66/00 
Ctrl F10 67/00 67/00 67/00 
Ctrl F114 (no key) 89/00 
Ctrl F12 (no key) 8A/00 
Ctri Num Lock - - 
Ctrl Scrolt Lock -- -- 
Ctrl Home 77/00 77100 
Ctrl Up Arrow 

Ctrl PgUp 

Ctrl Keypad - - 

Ctrl Left Arrow 73/00 

Cir! Center fa 

Ctrl Right Arrow 74/00 

Ctrl Keypad + - 

Ctri End 75/00 

Ctrl Down Arrow - 

Ctrl PgDn 76/00 

Ctrl Ins - 

Ctrl Del - 

Ctrl SysRq (no key) (no key) 
Ctrl Key 45 (no key) - - 
Ctrl Enter (no key) 1C/0A EO/0A 
Ctrl / (no key) - 95/00 
Ctrl PriSc (no key) 72/00 72/00 
Ctrl Break (no key) 00/00 00/00 
Ctrl Home (no key) 77/00 

Ctr Up (no key) - 

Ctrl PageUp (no key) 84/00 

Ctrl Left (no key) 73/00 

Ctrl Right (no key) 74/00 

Ctrl End (no key) 75/00 

Ctri Down (no key) - 

Ctrl PageDown (no key) 76/00 

Ctrl Insert (no key) - 

Ctrl Delete (no key) - 


** These combinations do not provide a keystroke for the application that is 
currently running, but they perform some other action. They are not put 
into the interrupt 16H queue. 

-- These combinations have no function and are ignored. 


Figure 7-3 (Part 3 of 3). Ctri Keyboard Keystrokes 
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The foliowing table lists the Alt keyboard keystrokes and the scan 
code/character code combinations that are returned through Interrupt 
16H. 


83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Alt Esc - -- 01/00 
Alt 1 78/00 78/00 78/00 
Alt 2 79/00 79/00 79/00 
Alt 3 7A/00 7TA/00 7A/00 
Alt 4 7B/00 7B/00 7B/00 
Alt 5 7C/00 7/00 7C/00 
Alt6 7D/00 7D/00 7D/00 
Alt 7 7E/00 7E/00 7E/00 
Alt 8 7F/00 7F/00 7F/00 
Alt 9 80/00 80/00 80/00 
Alt 0 81/00 81/00 81/00 
Alt - 82/00 82/00 82/00 
Alt = 83/00 83/00 83/00 
Alt Backspace - 0E/00 


Alt Tab = A5/00 
Alt gq 10/00 10/00 
Alt w 11/00 11/00 
Alte 12/00 12/00 
Alt r 13/00 13/00 


Altt 14/00 14/00 
Alt y 15/00 15/00 
Alt u 16/00 16/00 
Alt i 17/00 17/00 
Alt o 18/00 18/00 
Alt p 19/00 19/00 
Alt [ 1A/00 
Alt J 1B/00 
Alt Return 1C/00 
Alt Cirl ae 
Alta 1E/00 
Alt s 1F/00 
Alt d 20/00 
21/00 
22/00 
23/00 
24/00 
25/00 
26/00 
27/00 
28/00 
29/00 


Figure 7-4 (Part 1 of 3). Alt Keyboard Keystrokes 
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63-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Alt Shift ae 
Alt\ 2B/00 
Alt z 2C/00 
Alt x 2D/00 
2E/00 
2F/00 
30/00 
31/00 
32/00 
33/00 
34/00 
35/00 
- 37/00 
Alt Space 39/20 39/20 
Alt Caps Lock ie = 
Alt Ft 68/00 68/00 
Alt F2 69/00 69/00 
Alt F3 6A/00 6A/00 
Alt F4 6B/00 6B/00 
Alt F5 6C/00 6C/00 
Alt F6 6D/00 6D/00 
Alt F7 6E/00 6E/00 
Alt F8 6F/00 6F/00 
Alt F9 70/00 70/00 
Alt F10 71/00 71/00 
Alt F11 (no key) 8B/00 
Alt F12 (no key) 8C/00 
Alt Num Lock =“ on 
Alt Scroll Lock ce 
Alt Keypad - 4A/00 
Alt Keypad + 4E/00 
Alt Keypad Numbers # 
Alt De! - 
Alt SysRq (no key) 
Alt Key 45 (no key) 
Alt Enter (no key) A6/00 
Alt / “ A4/00 
Alt Print Screen (no key) ead 
Alt Pause (no key) ee, 
Alt Home (no key) 97/00 
Alt Up (no key) 98/00 
Alt PageUp (no key) 99/00 
Alt Left (no key) 9B/00 
Alt Right (no key) 9D/00 
Alt End (no key) 9F/00 
Alt Down (no key) A0/00 


Figure 7-4 (Part 2 of 3). Alt Keyboard Keystrokes 
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83-/84-Key 101-/102-Key 101-/102-Key 
Standard Standard Extended 
Keystroke Function Function Function 


Alt PageDown (no key) A1/00 
Alt Insert (no key) - A2/00 
Alt Delete (no key) - A3/00 


"* These combinations do not provide a keystroke for the application that is 
currently running, but they perform some other action. They are not put 
into the interrupt 16H queue. 

-- These combinations have no function and are ignored. 

# See the note below for use of the Alt key with the keypad number keys. 


Figure 7-4 (Part 3 of 3). Alt Keyboard Keystrokes 


Note: For all keyboards, the numeric keypad can be used in 
combination with the Alt key to type any ASCII character. The 
scan code (always 00) and character code are returned after 
the Alt key is released. For example, pressing the Alt key and 
keypad 1, then releasing the Alt key returns scan 
code/character code combination hex 00/01; pressing the Alt 
key and keypad 255, then releasing the Alt key returns scan 
code/character code combination hex 00/FF. 
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The following table lists the keyboard keystrokes and the scan 

| code/character code combinations that the 122-keyboard supports in 
addition to those listed previously. The Keyboard Read for the 

| 122-Key Keyboard function ((AH) = 20H) and the Keystroke Status for 
the 122-Key Keyboard function ((AH) =21H) must be used to return 
scan code/character code combinations for these keystrokes. 


122-Key 
Extended Extended 
Keystroke Function 


EC/00 
ED/00 
EE/00 
EF/00 
F4/00 
F5/00 
F6/00 
F7/00 
F8/00 
F9/00 
FA/00 
C0/00 
E8/00 
EraseEOF FO/00 
Clear FB/00 
Shift F13 C1/00 
Shift F14 3/00 
Shift F15 C4/00 
Shift F16 C5/00 
Shift F17 C6/00 
Shift F18 C7/00 
Shift F19 C8/00 
Shift F20 C9/00 
Shift F21 CA/00 
Shift F22 CB/00 
Shift F23 CC/00 
Shift F24 cbD/00 
Shift PA1 E9/00 
Shift EraseEOF F1/00 
Shift Clear FB/00 
Ctri F13 CE/00 
Ctrl F14 CF/00 
Ctrl F15 DO/00 
Ctrl F16 D1/00 
Ctrl F17 D2/00 
Ctrl F18 D3/00 
Ctrl F19 D4/00 
Ctrl F20 D5/00 
Ctrl F21 D6/00 
Ctrl F22 D7/00 
Ctrl F23 D8/00 


| Figure 7-5 (Part 7 of 2). Keyboard Keystrokes — 122-Key Keyboard 
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122-Key 
Extended Extended 
Keystroke Function 


Ctrl F24 D9/00 
Ctrt PAt EA/00 
Ctrl EraseEOF F2/00 
Ctrl Clear FC/00 
Alt F13 DA/0O 
Atl F14 DB/00 
Alt F15 DC/00 
Alt F16 DD/00 
Alt F17 DE/0O 
Alt F18 DF/00 
Alt F19 E2/00 
Alt F20 E3/00 
Alt F21 E4/00 
Alt F22 E5/00 
Alt F23 E6/00 
Alt F24 E7/00 
Alt PA1 EB/00 
Alt EraseEOF F3/00 
Alt Clear FD/00 


Figure 7-5 (Part 2 of 2). Keyboard Keystrokes — 122-Key Keyboard 


The following keys on the leftmost keypad of the 122-key keyboard do 
not produce scan code/character code combinations: 


Attn 

CrSel 

ExSel 

Copy Play 

The two blank keys. 
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